PO_FX_COMPONENT_PERF_SET 结构 (wdm.h)
PO_FX_COMPONENT_PERF_SET 结构表示设备中单个组件的性能状态集。
语法
typedef struct _PO_FX_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PO_FX_PERF_STATE_UNIT Unit;
PO_FX_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPO_FX_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;
成员
Name
一个可选字符串，用于描述由性能状态集控制的组件属性。 例如，“时钟频率”或“内存带宽”。
Flags
设置为 0。 目前，没有为此成员定义任何标志。
Unit
一个 PO_FX_PERF_STATE_UNIT 值，该值指定由性能状态集控制的单元的类型。
Type
一个PO_FX_PERF_STATE_TYPE值，该值指定集中的性能状态的类型， (离散数量的状态或) 最小值和最大值之间的状态连续分布。
Discrete
对于表示离散性能状态数 (即 类型 成员为 PoFxPerfStateTypeDiscrete) 的集，此嵌套结构描述状态。
Discrete.Count
集中的性能状态数。
Discrete.States
指向 PO_FX_PERF_STATE数组的 指针。 此数组的长度由 Count 成员指定。 每个数组元素描述集中的一个电源状态。
Range
对于表示性能状态连续分布 (类型成员为PoFxPerfStateTypeRange) 的集，此嵌套结构描述性能状态范围的最小值和最大值。
Range.Minimum
最小性能状态值。
Range.Maximum
最大性能状态值。
注解
当设备驱动程序调用 PoFxRegisterComponentPerfStates 例程向电源管理框架 (PoFx) 注册组件的性能状态支持时，驱动程序可以提供描述组件支持的性能状态集的 PO_FX_COMPONENT_PERF_INFO 结构。 PO_FX_COMPONENT_PERF_INFO 结构的 PerfStateSets 成员包含表示支持的性能状态的PO_FX_COMPONENT_PERF_SET结构数组。
大多数驱动程序应为每个组件定义一组性能状态。 例如，驱动程序可以定义一组性能状态来控制组件的时钟频率。 但是，某些驱动程序可能需要定义多个性能状态集，以控制组件性能状态的多个维度。 例如，驱动程序可以定义两组性能状态来控制时钟频率和总线带宽。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows 10 开始支持。 |
| 标头 | wdm.h (包括 Wudfwdm.h) |