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

另请参阅

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings