通过

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 是不透明的。 驱动程序在 PO_FX_CORE_DEVICE 结构的 DeviceContext 成员中指定了此指针，驱动程序用于将设备注册到 Windows 电源管理框架 (PoFx) 。

[in] Component

标识组件的索引。 此参数是设备驱动程序用于将设备注册到 PoFx 的 PO_FX_CORE_DEVICE 结构中的 Components 数组的索引。 如果 Components 数组包含 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 组件电源状态的详细信息，请参阅 组件级电源管理。

要求

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

另请参阅

PO_FX_CORE_DEVICE