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