(pepfx.h) PEP_COMPONENT_PERF_SET 结构
PEP_COMPONENT_PERF_SET结构描述 P 状态集中 (P 状态) 的性能状态。
语法
typedef struct _PEP_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPEP_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;
成员
Name
描述此 P 状态集控制的设备属性的可选字符串。 例如，此字符串可能是“时钟频率”或“内存带宽”。 如果此 P 状态没有可用的此类字符串， 则 Name 成员将设置为 NULL。 否则，此成员包含指向包含字符串 的UNICODE_STRING 结构的指针。
Flags
设置为零。 当前未为此成员定义标志位。
Unit
一个PEP_PERF_STATE_UNIT结构，指定表示此 P 状态集的性能值的单位。 组件性能可以以赫 (频率) 或位/秒表示， (带宽) 。
Type
一个PEP_PERF_STATE_TYPE枚举值，该值指示为此组件指定的性能信息的类型。 此成员指示此 P 状态集的性能值是指定为离散值列表还是连续值范围。
Discrete
此 P 状态集的离散性能值列表。
Discrete.Count
此 P 状态集中的 P 状态数。
Discrete.States
指向 PEP_PERF_STATE 结构的数组的指针，其中每个结构都描述此 P 状态集中的离散性能值。 Count 成员指定此数组中的元素数。 P 状态由其数组索引标识。 如果数组包含 N 个元素，则 P 状态索引的范围从 0 到 N–1。
Range
此 P 状态集的离散性能度量值的范围。
Range.Minimum
范围内的最小值。 此值以 Unit 成员指示的单位表示。
Range.Maximum
范围内的最大值。 此值以 Unit 成员指示的单位表示。
注解
未命名的联合包含此 P 状态的性能度量值。 如果 () ，此联合包含离散值列表（如果 Type == PepPerfStateTypeDiscrete) ）或连续 (值范围（如果 Type == PepPerfStateTypeRange) ）。
PEP_COMPONENT_PERF_INFO的 PerfStateSets 成员是PEP_COMPONENT_PERF_SET结构数组中的第一个元素。 PEP_COMPONENT_PERF_SET 结构的所有成员都包含由 Windows 电源管理框架 (PoFx) 提供的输入值。 平台扩展插件 (PEP) 不得写入此结构。
设备驱动程序使用 PO_FX_COMPONENT_PERF_SET 结构，这类似于 PEP_COMPONENT_PERF_SET 结构。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows 10 开始支持。 |
| 标头 | pepfx.h (包括 Pep_x.h) |