Функция PoClearPowerRequest (ntifs.h)

  • Статья

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

Синтаксис

NTSTATUS PoClearPowerRequest(
  [in, out] PVOID              PowerRequest,
  [in]      POWER_REQUEST_TYPE Type
);

Параметры

[in, out] PowerRequest

Указатель на объект запроса на питание, созданный подпрограммой PoCreatePowerRequest .

[in] Type

Тип запроса на питание. Задайте для этого параметра следующее значение перечисления POWER_REQUEST_TYPE :

  • PowerRequestSystemRequired

Возвращаемое значение

PoClearPowerRequest возвращает STATUS_SUCCESS, если вызов выполнен успешно. Если вызов завершается сбоем, возможные коды возврата ошибок:

Код возврата Описание
STATUS_NOT_SUPPORTED Параметр Type имеет неподдерживаемое значение.

Комментарии

Драйвер может вызвать подпрограмму PoSetPowerRequest , чтобы запросить переопределение диспетчером питания нескольких типов поведения питания по умолчанию, которые указаны как POWER_REQUEST_TYPE значения перечисления. Чтобы восстановить поведение по умолчанию, драйвер отменяет запрос, вызывая подпрограмму PoClearPowerRequest .

Диспетчер питания поддерживает количество активных запросов для каждого типа запроса на питание. Подпрограмма PoSetPowerRequest увеличивает число для указанного типа запроса на питание на единицу. Подпрограмма PoClearPowerRequest уменьшает количество на один. Ненулевое число указывает, что запросы от одного или нескольких компонентов активны. После уменьшения счетчика до нуля диспетчер питания восстанавливает поведение по умолчанию для указанного типа запроса на питание.

Требования

Требование Значение
Минимальная версия клиента Windows 7
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

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

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest