Функция PoSetPowerRequest (wdm.h)

Статья
08/08/2023

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

Синтаксис

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

Параметры

[in, out] PowerRequest

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

[in] Type

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

PowerRequestSystemRequired

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

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

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

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

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

Требования

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

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

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest

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