PoClearPowerRequest 函数 (wdm.h)

PoClearPowerRequest 例程递减指定电源请求类型的计数。

语法

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

参数

[in, out] PowerRequest

指向 PoCreatePowerRequest 例程创建的电源请求对象的指针。

[in] Type

电源请求的类型。 将此参数设置为以下 POWER_REQUEST_TYPE 枚举值:

  • PowerRequestSystemRequired

返回值

如果调用成功,PoClearPowerRequest 将返回STATUS_SUCCESS。 如果调用失败,则可能的错误返回代码包括:

返回代码 说明
STATUS_NOT_SUPPORTED
参数 类型 设置为不受支持的值。

注解

驱动程序可以调用 PoSetPowerRequest 例程,以请求 电源管理器 替代多种类型的默认电源行为,这些行为指定为 POWER_REQUEST_TYPE 枚举值。 若要还原默认行为,驱动程序通过调用 PoClearPowerRequest 例程来取消请求。

电源管理器维护每种电源请求类型的活动请求计数。 PoSetPowerRequest 例程将指定电源请求类型的计数递增 1。 PoClearPowerRequest 例程将计数递减一。 非零计数指示来自一个或多个组件的请求处于活动状态。 计数递减到零后,电源管理器将还原指定电源请求类型的默认行为。

要求

要求
最低受支持的客户端 从 Windows 7 开始可用。
目标平台 通用
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另请参阅

POWER_REQUEST_TYPE

PoCreatePowerRequest

PoSetPowerRequest