EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE回调函数 (wdfdevice.h)
[仅适用于 KMDF]
EvtDeviceWdmPostPoFxRegisterDevice 回调函数在向 Power Framework 注册框架后执行特定于设备的操作。
语法
EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;
NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
[in] WDFDEVICE Device,
[in] POHANDLE PoHandle
)
{...}
参数
[in] Device
框架设备对象的句柄。
[in] PoHandle
表示设备向 Power Framework 注册的句柄。
返回值
一个 NTSTATUS 值,指示在此回调中执行的操作是成功还是失败。 如果返回失败,框架反过来会 IRP_MN_START_DEVICE失败。
注解
如果要为定义多个功能电源状态的单组件设备编写 KMDF 驱动程序,则可以注册 EvtDeviceWdmPostPoFxRegisterDevice 回调函数,以便在框架注册到电源管理框架 (PoFx) 后接收通知。
若要注册 EvtDeviceWdmPostPoFxRegisterDevice,驱动程序必须调用 WdfDeviceWdmAssignPowerFrameworkSettings。
在 EvtDeviceWdmPostPoFxRegisterDevice 中收到的 POHANDLE 在驱动程序从 EvtDeviceWdmPrePoFxUnregisterDevice 返回之前仍然有效。
驱动程序可以使用 POHANDLE 调用 PoFxSetComponentLatency、 PoFxSetComponentResidency 和 PoFxSetComponentWake ,以指定电源框架的延迟、驻留和唤醒提示。
驱动程序还可以使用 POHANDLE 调用 PoFxPowerControl ,以向 PoFx 发送电源控制请求。
多组件设备的 KMDF 驱动程序不提供 EvtDeviceWdmPostPoFxRegisterDevice。 相反,此类驱动程序在调用 PoFxRegisterDevice 时接收 POHANDLE。 有关详细信息,请参阅 支持 Multiple-Component 设备的多个功能电源状态。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
最低 KMDF 版本 | 1.11 |
标头 | wdfdevice.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL |