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