PO_FX_DIRECTED_POWER_UP_CALLBACK回调函数 (wdm.h)

PO_FX_DIRECTED_POWER_UP_CALLBACK回调函数由客户端驱动程序实现,以代表 DFx(定向 PoFx)处理特定于驱动程序的活动。

语法

PO_FX_DIRECTED_POWER_UP_CALLBACK PoFxDirectedPowerUpCallback;

void PoFxDirectedPowerUpCallback(
  PVOID Context,
  ULONG Flags
)
{...}

参数

Context

提供指向传递给 PoFxRegisterDevice的上下文的指针。

Flags

保留以供将来使用。

返回值

没有

言论

向 PoFx 注册以实现运行时空闲电源管理支持的 WDM 驱动程序需要实现此回调才能添加 DFx 支持。

通过设置 PO_FX_DEVICE_V3 结构的相应成员,然后调用 PoFxRegisterDevice来注册此回调函数的实现。

当系统确定设备在以前在 PO_FX_DIRECTED_POWER_DOWN_CALLBACK 回调函数中关闭电源后需要启动时,将调用此回调。 当系统退出新式待机时,可能需要启动设备,激活器 开始运行,或者发生硬件启动唤醒。

调用此回调时,驱动程序通常会执行以下高级任务:

  • 请求 D0 IRP 为设备供电。

  • D0 IRP 完成后,调用 PoFxReportDevicePoweredOn

  • 取消阻止 I/O 队列并正常启动处理请求。

驱动程序完成定向电源调用后,它可以恢复运行时空闲(RTD3)行为。

合同与 S0 非常相似,尽管没有涉及 S-IRP。

请注意,如果涉及设备层次结构,则定向电源框架要求子设备在父设备之前关闭电源。 对于给定的父设备,由于 权力关系,直接子级(由父级枚举)和间接子级。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1903
标头 wdm.h (包括 Wdm.h)

另请参阅

定向电源管理框架 简介

PO_FX_DIRECTED_POWER_DOWN_CALLBACK