PEP_QUERY_COMPONENT_PERF_SET 结构 (pep_x.h)
PEP_QUERY_COMPONENT_PERF_SET结构包含有关组件 (P 状态集) 的一组性能状态值的查询信息。
语法
typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
PEPHANDLE DeviceHandle;
ULONG Component;
ULONG Set;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;
成员
DeviceHandle
标识设备的 PEPHANDLE 值。 PEP 提供了此句柄，以响应以前的 PEP_DPM_REGISTER_DEVICE 通知。
Component
标识组件的索引。 此成员是 PEP 先前为响应此设备的PEP_DPM_REGISTER_DEVICE通知而提供的 PEP_DEVICE_REGISTER_V2 结构中的 Components 数组的索引。 如果 Components 数组包含 N 个元素，则组件索引的范围为 0 到 N–1。
Set
标识此 P 状态集的索引。 如果此组件具有 M P 状态集，则 P 状态集索引范围为 0 到 M-1。 PEP 之前指定了 P 状态集的数目，以响应 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知。
Flags
一组输入标志。 当前未为此成员定义标志位，该成员始终为零。
Unit
一个PEP_PERF_STATE_UNIT枚举值，该值指示此 P 状态集的值是否以hz (频率单位) 或每秒位表示， (带宽单位) 。
Type
PEP_PERF_STATE_TYPE枚举值，该值指示此 P 状态集的性能值是表示为离散值列表还是连续值范围。
Discrete
如果 Type == PepPerfStateTypeDiscrete，请使用此结构。
Discrete.Count
此 P 状态集中的离散性能值的数目。
Range
如果 Type == PepPerfStateTypeRange，请使用此结构。
Range.Minimum
此 P 状态集的性能值范围内的最小值。 此值以 Unit 成员指示的度量单位表示。
Range.Maximum
此 P 状态集的性能值范围内的最大值。 此值以 Unit 成员指示的度量单位表示。
注解
未命名的联合表示此 P 状态集中的离散性能值数，或此 P 状态集中的值范围。
此结构由 PEP_DPM_QUERY_COMPONENT_PERF_SET 通知使用。 发送此通知时， DeviceHandle、 Component、 Set 和 Flags 成员包含 Windows 电源管理框架 (PoFx) 提供的输入值。 Discrete 成员或 Range 成员包含 PEP 为响应通知而写入结构的输出值。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows 10 开始支持。 |
| 标头 | pep_x.h (包括 Pep_x.h) |