структура USER_POWER_POLICY (powrprof.h)

Статья
08/25/2023

Содержит параметры политики управления питанием, которые являются уникальными для каждой схемы управления питанием для пользователя. Эта структура является частью структуры POWER_POLICY .

Синтаксис

typedef struct _USER_POWER_POLICY {
  ULONG               Revision;
  POWER_ACTION_POLICY IdleAc;
  POWER_ACTION_POLICY IdleDc;
  ULONG               IdleTimeoutAc;
  ULONG               IdleTimeoutDc;
  UCHAR               IdleSensitivityAc;
  UCHAR               IdleSensitivityDc;
  UCHAR               ThrottlePolicyAc;
  UCHAR               ThrottlePolicyDc;
  SYSTEM_POWER_STATE  MaxSleepAc;
  SYSTEM_POWER_STATE  MaxSleepDc;
  ULONG               Reserved[2];
  ULONG               VideoTimeoutAc;
  ULONG               VideoTimeoutDc;
  ULONG               SpindownTimeoutAc;
  ULONG               SpindownTimeoutDc;
  BOOLEAN             OptimizeForPowerAc;
  BOOLEAN             OptimizeForPowerDc;
  UCHAR               FanThrottleToleranceAc;
  UCHAR               FanThrottleToleranceDc;
  UCHAR               ForcedThrottleAc;
  UCHAR               ForcedThrottleDc;
} USER_POWER_POLICY, *PUSER_POWER_POLICY;

Члены

Revision

Текущий уровень редакции структуры. Задайте это значение, вызвав Метод GetCurrentPowerPolicies или ReadPwrScheme , прежде чем использовать структуру USER_POWER_POLICY для настройки политики управления питанием.

IdleAc

Структура POWER_ACTION_POLICY , которая определяет действие питания системы, которое необходимо инициировать, когда система работает от питания переменного тока (служебная программа) и истекает срок действия таймера простоя системы.

IdleDc

Структура POWER_ACTION_POLICY , которая определяет действие питания системы, которое необходимо инициировать, когда система работает от батареи и истекает срок действия таймера простоя системы.

IdleTimeoutAc

Время, в течение которого уровень активности системы должен оставаться ниже порогового значения обнаружения простоя до истечения срока действия таймера простоя системы при работе с переменным питанием (служебная программа) в секундах.

Этот элемент игнорируется, если система выполняет автоматическое возобновление, так как отсутствует пользователь. Чтобы временно поддерживать работу системы во время выполнения задачи приложением, используйте функцию SetThreadExecutionState .

IdleTimeoutDc

IdleSensitivityAc

Уровень активности системы, определяющий порог для обнаружения простоя при работе системы с питанием от переменного тока (служебной программы), выраженный в процентах.

IdleSensitivityDc

Уровень активности системы, определяющий порог для обнаружения простоя, когда система работает от батареи, выраженный в процентах.

ThrottlePolicyAc

Политика динамического регулирования процессора, используемая при работе системы с питанием ac (служебная программа).

ThrottlePolicyDc

Политика динамического регулирования процессора, используемая, когда система работает от аккумулятора.

MaxSleepAc

Максимальное состояние спящего режима системы, когда система работает от питания ac (служебная программа). Этот элемент должен быть одним из SYSTEM_POWER_STATE значений типа перечисления.

MaxSleepDc

Максимальное состояние спящего режима системы, когда система работает от батареи. Этот элемент должен быть одним из SYSTEM_POWER_STATE значений типа перечисления.

Reserved[2]

Зарезервировано.

VideoTimeoutAc

Время до выключения дисплея, когда система работает от питания ac (служебная программа), в секундах.

VideoTimeoutDc

Время перед выключением дисплея, когда система работает от батареи, в секундах.

SpindownTimeoutAc

Время до выключения питания фиксированных дисков, когда система работает от питания переменного тока (служебной программы), в секундах.

SpindownTimeoutDc

Время перед выключением питания фиксированных дисков, когда система работает от батареи, в секундах.

OptimizeForPowerAc

Если этот элемент имеет значение TRUE, система включит вентиляторы охлаждения и запустит процессор на полной скорости, если указано пассивное охлаждение и система работает от питания переменного тока (служебной программы). Это приводит к смещению операционной системы в сторону использования вентилятора и запуска процессора на полной скорости.

OptimizeForPowerDc

Если этот элемент имеет значение TRUE, система включит вентиляторы охлаждения и запустит процессор на полной скорости, если указано пассивное охлаждение и система работает от батареи. Это приводит к смещению операционной системы в сторону использования вентилятора и запуска процессора на полной скорости.

FanThrottleToleranceAc

Нижний предел, до который процессор может быть отрегулировать до включения системных вентиляторов в ответ на тепловое событие, когда система работает от питания переменного тока (служебной) питания, выраженное в процентах.

FanThrottleToleranceDc

Нижний предел, к которому процессор может быть отрегулировать до включения системных вентиляторов в ответ на тепловое событие во время работы системы от аккумулятора, выраженное в процентах.

ForcedThrottleAc

Уровень регулирования процессора, устанавливаемый системой во время работы компьютера с питанием переменного тока (служебной программы), выраженный в процентах.

ForcedThrottleDc

Уровень регулирования процессора, устанавливаемый системой во время работы компьютера от батареи, выраженный в процентах.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	powrprof.h

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

POWER_ACTION_POLICY

POWER_POLICY

Share via