Поделиться через

перечисление POWER_REQUEST_TYPE (wdm.h)

  • Статья

Перечисление POWER_REQUEST_TYPE указывает тип запроса на питание.

Синтаксис

typedef enum _POWER_REQUEST_TYPE {
  PowerRequestDisplayRequired,
  PowerRequestSystemRequired,
  PowerRequestAwayModeRequired,
  PowerRequestExecutionRequired
} POWER_REQUEST_TYPE, *PPOWER_REQUEST_TYPE;

Константы

 
PowerRequestDisplayRequired
Не используется драйверами. Дополнительные сведения см. в подразделе "Примечания".
PowerRequestSystemRequired
Запрещает компьютеру автоматически переходить в спящий режим после периода бездействия пользователя.
PowerRequestAwayModeRequired
Не используется драйверами. Дополнительные сведения см. в подразделе "Примечания".
PowerRequestExecutionRequired
Не используется драйверами. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Это перечисление используется подпрограммами PoClearPowerRequest и PoSetPowerRequest в режиме ядра. Драйверы, вызывающие эти подпрограммы, должны указывать значение перечисления PowerRequestSystemRequired .

Остальные три значения перечисления — PowerRequestDisplayRequired, PowerRequestAwayModeRequired и PowerRequestExecutionRequired — не используются драйверами. Приложения указывают эти типы запросов на питание в вызовах функций PowerSetRequest и PowerClearRequest .

Запрос питания PowerRequestDisplayRequired имеет следующие эффекты:

  • После периода бездействия пользователя отображение сеанса остается включенным и не отключается автоматически.

  • Экранная заставка не запускается автоматически после периода бездействия пользователя.

  • Сеанс не будет автоматически заблокирован после периода бездействия пользователя. Если сеанс уже заблокирован, когда драйвер отправляет запрос на питание, сеанс остается заблокированным.

В дополнение к PowerRequestDisplayRequired необходимо использовать элемент PowerRequestSystemRequired, чтобы экран оставался включен, а система не войдет в спящий режим на время выполнения запроса.

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

Пока действует запрос на питание PowerRequestExecutionRequired , вызывающий процесс продолжает выполняться, а не приостанавливается или завершается механизмами управления жизненным циклом процессов (PLM). Время и время выполнения процесса зависит от параметров операционной системы и политики управления питанием. Этот тип запроса на питание поддерживается, начиная с Windows 8.

В современных резервных системах с питанием постоянного тока запросы на питание завершаются через 5 минут.

За исключением PowerRequestAwayModeRequired в системах традиционного режима сна (S3), запросы на питание завершаются при входе в спящий режим, инициированном пользователем (кнопка питания, закрытие крышки или выбор спящего режима в меню "Пуск").

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 7.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

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

PoClearPowerRequest

PoSetPowerRequest

PowerClearRequest

PowerSetRequest