перечисление POWER_REQUEST_TYPE (ntpoapi.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 имеет следующие эффекты:

  • После периода бездействия пользователя отображение сеанса остается включенным и не отключается автоматически. Если дисплей уже отключен, запрос на включение питания включает его.
  • Заставка не запускается автоматически после периода бездействия пользователя. Если заставка уже запущена, запрос питания останавливает экранную заставку.
  • Сеанс не будет автоматически заблокирован после периода бездействия пользователя. Если сеанс уже заблокирован, когда драйвер отправляет запрос на питание, сеанс остается заблокированным.
В то время как запрос на питание PowerRequestAwayModeRequired действует, если пользователь пытается переключить компьютер в спящий режим (например, нажав кнопку Пуск и спящий режим), диспетчер питания отключает звук и видео, чтобы компьютер выглядел в спящем режиме, но компьютер продолжает работать.

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

Требования

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

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

PoClearPowerRequest

PoSetPowerRequest

PowerClearRequest

PowerSetRequest