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) |