wdm.h) (PO_FX_COMPONENT_V2 结构

  • 项目

PO_FX_COMPONENT 结构描述设备中组件的电源状态属性。

语法

typedef struct _PO_FX_COMPONENT_V2 {
  GUID                        Id;
  ULONGLONG                   Flags;
  ULONG                       DeepestWakeableIdleState;
  ULONG                       IdleStateCount;
  PPO_FX_COMPONENT_IDLE_STATE IdleStates;
  ULONG                       ProviderCount;
  PULONG                      Providers;
} PO_FX_COMPONENT_V2, *PPO_FX_COMPONENT_V2;

成员

Id

一个组件 ID，它相对于设备中的其他组件唯一标识此组件。 如果电源管理框架 (PoFx) 要求组件 ID 将此组件与同一设备中的其他类似组件区分开来，驱动程序应为此成员指定非零值。 此成员是可选的。 如果未使用此成员，则必须将其设置为所有零。

Flags

此成员可以设置为以下标志位： PO_FX_COMPONENT_FLAG_F0_ON_DX。 有关详细信息，请参阅“备注”。

DeepestWakeableIdleState

组件可从中唤醒的最深 Fx 状态的索引。 为 F0 指定 0，为 F1 指定 1，依。 此索引必须小于 IdleStateCount。

IdleStateCount

IdleStates 成员指向的数组中的元素数。 此外，此成员指定组件支持的 Fx 电源状态数。 一个组件必须支持至少一个 fx 状态 (F0) 。

IdleStates

指向 PO_FX_COMPONENT_IDLE_STATE数组的 指针。 此数组的长度由 IdleStateCount 成员指定。 每个数组元素指定组件支持的 Fx 电源状态的属性。 元素 0 描述 F0，元素 1 描述 F1 等。

ProviderCount

一个 值，该值指定此组件所依赖的组件数。 有关详细信息，请参阅“备注”下的 “组件依赖项 ”。

Providers

指向此组件所依赖的组件索引数组的指针。 有关详细信息，请参阅“备注”下的 “组件依赖项 ”。

注解

当设备驱动程序向 PoFx 注册设备时，驱动程序将提供保存注册信息的 PO_FX_DEVICE 结构。 此结构包含 PO_FX_COMPONENT 结构的数组。 此数组中的元素描述设备中各个组件的电源属性。 PoFx 使用此数组中的信息来管理这些组件的电源设置。

Id 成员包含 PoFx 可用于唯一标识组件的组件 ID。 不要将组件 ID 与组件索引混淆， PoFxActivateComponent 等例程使用该索引来标识已注册设备中的组件。 组件索引是设备驱动程序用于将设备注册到 PoFx 的PO_FX_DEVICE结构中 Components 数组的索引。 如果 Components 数组包含 N 个元素，则组件索引是 0 到 N–1 范围内的整数值。 相比之下，组件 ID 是 GUID 值。

如果驱动程序 PO_FX_VERSION_V2在注册 PoFx (（即在调用 PoFxRegisterDevice 例程期间，驱动程序为传递给 Device 参数 ) 的 PO_FX_DEVICE 结构的 Version 成员指定值PO_FX_VERSION_V2，则 Flags 成员可以设置为PO_FX_COMPONENT_FLAG_F0_ON_DX值。 如果指定 了PO_FX_COMPONENT_FLAG_F0_ON_DX 标志，则 PoFx 将在 Dx 转换期间将组件置于 F0 电源状态，并用于等待/唤醒 IRP。 在将 Dx IRP 或等待/唤醒 IRP 调度到设备堆栈 () 发生的事件之前，电源管理器会将组件转换为 F0 状态。 组件将保留在 F0 中，直到取消或完成唤醒/等待 IRP，或者 Dx IRP 完成并且驱动程序调用 了 PoFxReportDevicePoweredOn 例程 (上) 发生的事件。

组件依赖项

PoFx 支持设备 (中的逻辑组件依赖项，但不支持跨不同设备) 。 在每个组件的设备注册过程中，驱动程序可以提供一个数字 (ProviderCount 成员) 和组件索引数组 (提供程序 成员) 此组件所依赖;这些称为 提供程序。 PoFx 保证组件在其所有提供程序都处于活动状态之前不会变为活动状态。

组件依赖关系形成一个有向图，其中边缘从依赖组件指向提供程序，并表示依赖项。 在设备注册期间，PoFx 会验证依赖项关系图：不允许循环和重复边缘，深度优先搜索遍历的图形深度不能超过 4。 PoFx 还根据依赖项关系图设置组件的活动引用计数;也就是说，每个提供程序的活动引用计数对于依赖它的每个组件递增一次。

在组件激活期间，PoFx 首先异步激活所有提供程序。 组件处于活动状态后，PoFx 会检查每个依赖组件，并在必要时继续激活它们。

当组件转换为空闲状态时，PoFx 首先使依赖组件处于空闲状态。 驱动程序完成 ComponentIdleConditionCallback 并且平台扩展插件 (PEP) 收到组件空闲通知后，PoFx 以递归方式遍历广度优先遍历依赖项关系图，并异步空闲每个提供程序。

要求

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

另请参阅

组件级电源管理

PO_FX_COMPONENT_IDLE_STATE

PO_FX_DEVICE