структура SYSTEM_POWER_POLICY (winnt.h)
Содержит сведения о текущей системной политике управления питанием.
Синтаксис
typedef struct _SYSTEM_POWER_POLICY {
DWORD Revision;
POWER_ACTION_POLICY PowerButton;
POWER_ACTION_POLICY SleepButton;
POWER_ACTION_POLICY LidClose;
SYSTEM_POWER_STATE LidOpenWake;
DWORD Reserved;
POWER_ACTION_POLICY Idle;
DWORD IdleTimeout;
BYTE IdleSensitivity;
BYTE DynamicThrottle;
BYTE Spare2[2];
SYSTEM_POWER_STATE MinSleep;
SYSTEM_POWER_STATE MaxSleep;
SYSTEM_POWER_STATE ReducedLatencySleep;
DWORD WinLogonFlags;
DWORD Spare3;
DWORD DozeS4Timeout;
DWORD BroadcastCapacityResolution;
SYSTEM_POWER_LEVEL DischargePolicy[NUM_DISCHARGE_POLICIES];
DWORD VideoTimeout;
BOOLEAN VideoDimDisplay;
DWORD VideoReserved[3];
DWORD SpindownTimeout;
BOOLEAN OptimizeForPower;
BYTE FanThrottleTolerance;
BYTE ForcedThrottle;
BYTE MinThrottle;
POWER_ACTION_POLICY OverThrottled;
} SYSTEM_POWER_POLICY, *PSYSTEM_POWER_POLICY;
Члены
Revision
Текущая редакция структуры.
PowerButton
Структура POWER_ACTION_POLICY , определяющая действие питания системы, инициируемое при нажатии кнопки питания системы.
SleepButton
Структура POWER_ACTION_POLICY , определяющая действие питания системы, инициируемое при нажатии кнопки спящего режима.
LidClose
Структура POWER_ACTION_POLICY , которая определяет действие питания системы, инициирующееся при закрытии переключателя крышки системы.
LidOpenWake
Максимальное состояние питания (наибольшее значение Sx), из которого событие открытия крышки должно разбудить систему. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.
Reserved
Зарезервировано.
Idle
Структура POWER_ACTION_POLICY , определяющая действие питания системы, которое инициируется по истечении срока действия таймера простоя системы.
IdleTimeout
Время, в течение которого уровень активности системы должен оставаться ниже порогового значения обнаружения простоя до истечения срока действия таймера простоя системы в секундах.
IdleSensitivity
Уровень системной активности, определяющий порог для обнаружения простоя, выраженный в процентах.
DynamicThrottle
Текущая политика динамического регулирования системного процессора. Этот элемент должен быть одним из значений, описанных в разделе Константы политики управления производительностью процессора.
Spare2[2]
Зарезервировано.
MinSleep
Минимальное состояние спящего режима системы (наименьшее значение Sx), поддерживаемое в настоящее время. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.
MaxSleep
Максимальное состояние спящего режима системы (наибольшее значение Sx), поддерживаемое в настоящее время. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE.
ReducedLatencySleep
Состояние питания системы (значение Sx), которое необходимо ввести в действие спящего режима системы при наличии невыполненных требований к задержке. Этот элемент должен быть одним из значений типа перечисления SYSTEM_POWER_STATE. Если приложение вызывает RequestWakeupLatency с LT_LOWEST_LATENCY, вместо MaxSleep будет использоваться ReducedLatencySleep.
WinLogonFlags
Этот элемент может быть равен нулю или WINLOGON_LOCK_ON_SLEEP (0x00000001).
Spare3
Зарезервировано.
DozeS4Timeout
Время ожидания между переходом в состояние приостановки и переходом в спящий режим гибернации в секундах. Нулевое значение указывает на отсутствие гибернации.
BroadcastCapacityResolution
Разрешение изменения текущей емкости батареи, которое должно привести к уведомлению системы о событии изменения состояния питания системы.
DischargePolicy[NUM_DISCHARGE_POLICIES]
Массив структур SYSTEM_POWER_LEVEL , определяющих действия, выполняемые при событиях разряда батареи системы.
VideoTimeout
Время перед отключением дисплея в секундах.
VideoDimDisplay
Если этот элемент имеет значение TRUE, система включает поддержку затемнения дисплея.
VideoReserved[3]
Зарезервировано.
SpindownTimeout
Время перед отключением питания на фиксированных дисках в секундах.
OptimizeForPower
Если этот элемент имеет значение TRUE, система будет включать вентиляторы охлаждения и запускать процессор на полной скорости при указании пассивного охлаждения. Это приводит к смещению операционной системы к использованию вентилятора и запуску процессора на полной скорости.
FanThrottleTolerance
Нижний предел, до который процессор может быть отрегулировать до включения системных вентиляторов в ответ на тепловое событие, выраженное в процентах.
ForcedThrottle
Уровень регулирования процессора, устанавливаемый системой, выраженный в процентах.
MinThrottle
Минимальный уровень регулирования процессора, выраженный в процентах.
OverThrottled
Структура POWER_ACTION_POLICY , определяющая действие питания системы, инициируемое в ответ на тепловое событие, когда регулирование процессора не может адекватно снизить температуру системы.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Верхняя часть | winnt.h (включая Windows.h) |