PEP_COMPONENT_PERF_SET结构(pep_x.h)
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 状态,则 名称 成员设置为 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
范围内的最小值。 此值以 单位 成员指示的单位表示。
Range.Maximum
区域中的最大值。 此值以 单位 成员指示的单位表示。
言论
未命名的联合包含此 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 开始支持。 |
标头 | pep_x.h (包括 Pep_x.h) |