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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[in, out] PowerRequest

Указатель на объект power request, созданный подпрограммой PoCreatePowerReque st.

[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

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