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) 行为。

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

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

要求

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

另请参阅

导向式电源管理框架简介

PO_FX_DIRECTED_POWER_DOWN_CALLBACK