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

Подпрограмма 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
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

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

POWER_REQUEST_TYPE

PoClearPowerRequest

PoCreatePowerRequest