структура 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)

См. также раздел

CallNtPowerInformation

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL