Функция PoSetPowerRequest (ntifs.h)
Подпрограмма PoSetPowerRequest увеличивает число для указанного типа запроса питания.
Синтаксис
NTSTATUS PoSetPowerRequest(
[in, out] PVOID PowerRequest,
[in] POWER_REQUEST_TYPE Type
);
Параметры
[in, out] PowerRequest
Указатель на объект power request, созданный подпрограммой PoCreatePowerReque st.
[in] Type
Тип запроса на питание. Задайте для этого параметра следующее значение перечисления POWER_REQUEST_TYPE:
- PowerRequestSystemRequired
Возвращаемое значение
PoSetPowerRequest возвращает STATUS_SUCCESS, если вызов выполнен успешно. Если вызов завершается ошибкой, возможные коды возврата ошибок включают следующие:
| Возвращаемый код | Описание |
|---|---|
| STATUS_NOT_SUPPORTED | Параметр типа имеет неподдерживаемое значение. |
Замечания
Драйвер может вызывать подпрограмму 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 |