PoFxStartDevicePowerManagement 函数 (wdm.h)

PoFxStartDevicePowerManagement 例程完成设备注册到电源管理框架 (PoFx) ,并启动设备电源管理。

语法

void PoFxStartDevicePowerManagement(
  [in] POHANDLE Handle
);

参数

[in] Handle

一个句柄,表示设备在 PoFx) (电源管理框架的注册。 设备驱动程序以前从 PoFxRegisterDevice 例程收到此句柄。

返回值

备注

驱动程序调用 PoFxRegisterDevice 例程以将设备注册到 PoFx 后,设备中的所有组件都完全处于打开状态并处于活动状态,以便驱动程序可以完成硬件初始化。 若要启动主动电源管理,驱动程序必须调用 PoFxStartDevicePowerManagement。 默认情况下,此调用会将所有组件切换到空闲状态。

在 PoFxStartDevicePowerManagement 将组件切换到空闲条件后,PoFx 可能会立即开始调用驱动程序的回调例程,甚至在 PoFxStartDevicePowerManagement 返回之前。 PoFx 调用驱动程序的 ComponentIdleConditionCallback 回调例程,以指示组件已切换到空闲条件。 驱动程序不得访问处于空闲状态的组件。 在驱动程序可以访问组件之前,驱动程序必须调用 PoFxActivateComponent 并等待 PoFx 调用驱动程序的 ComponentActiveConditionCallback 回调例程。 此回调通知驱动程序组件处于活动状态,可以安全地访问。

如果驱动程序要求组件在电源管理启动后立即处于活动状态,则驱动程序必须通过调用 PoFxActivateComponent 例程显式激活该组件,并且此调用必须在 PoFxRegisterDevice 调用之后、 PoFxStartDevicePowerManagement 调用之前发生。

要求

要求
最低受支持的客户端 从Windows 8开始可用。
目标平台 通用
标头 wdm.h
Library Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL PASSIVE_LEVEL

另请参阅

ComponentActiveConditionCallback

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice