PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK回调函数 (wdm.h)

ComponentCriticalTransitionCallback 回调例程处理 F0(完全打开)和低功率 Fx 组件电源状态之间的指定组件的转换。

语法

PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;

void PoFxComponentCriticalTransitionCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Active
)
{...}

参数

[in] Context

指向设备上下文的指针。 设备驱动程序使用此上下文来存储有关设备的当前电源状态的信息。 此上下文是驱动程序定义的,并且与 PoFx 不透明。 驱动程序在 DeviceContextPO_FX_CORE_DEVICE 结构的成员中指定了此指针,驱动程序用于将设备注册到 Windows 电源管理框架(PoFx)。

[in] Component

标识组件的索引。 此参数是设备驱动程序用于向 PoFx 注册设备的 PO_FX_CORE_DEVICE 结构中 组件 数组的索引。 如果 组件 数组包含 N 个元素,则组件索引的范围从 0 到 N–1。

[in] Active

指示此通知是否用于转换为 F0 组件电源状态。 如果为 TRUE,则组件刚刚完成了从低功率 Fx 状态到 F0 的转换。 如果为 FALSE,则组件将开始从 F0 转换为低功率 Fx 状态。

返回值

没有

言论

此回调例程由设备驱动程序实现,由 PoFx 调用。 PoFx 调用此例程,以通知设备组件的电源转换的驱动程序。

PO_FX_CORE_DEVICE 结构的 ComponentCriticalTransitionCallback 成员是指向 ComponentCriticalTransitionCallback 回调例程的指针。 指向 PO_FX_CORE_DEVICE 结构的指针作为 PoFxRegisterCoreDevice 调用中的输入参数传递,该调用向 Windows 电源管理框架(PoFx)注册核心设备。

若要处理对此例程的调用,设备驱动程序将保存或还原设备中指定组件的注册状态或其他硬件上下文。

如果 Active = TRUE,则 PoFx 在组件完成从低功率 Fx 状态到 F0 的转换 后, 调用此例程。 在此调用中,例程将还原组件以前保存的硬件上下文。

如果 Active = FALSE,则 PoFx 在组件启动从 F0 到低功率 Fx 状态的挂起转换 之前,已调用此例程。 在此调用中,例程保存组件的硬件上下文,以便稍后可以还原此上下文。

有关 Fx 组件电源状态的详细信息,请参阅 Component-Level 电源管理

要求

要求 价值
最低支持的客户端 从 Windows 10 开始支持。
目标平台 窗户
标头 wdm.h (包括 Wudfwdm.h)

另请参阅

PO_FX_CORE_DEVICE