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 例程将指定电源请求类型的计数递增 1。 PoClearPowerRequest 例程将计数递减一。 非零计数指示来自一个或多个组件的请求处于活动状态。 计数递减为零后，计算机将恢复为指定电源请求类型的默认行为。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7 |
| 目标平台 | 通用 |
| 标头 | ntifs.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |