Функция 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 |