PEP_QUERY_COMPONENT_PERF_SET结构(pepfx.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_DEVICE_REGISTER_V2 结构中 Components 数组的索引,PEP 以前为响应此设备的 PEP_DPM_REGISTER_DEVICE 通知而提供的数组。 如果 组件 数组包含 N 个元素,则组件索引的范围从 0 到 N–1。
Set
标识此 P 状态集的索引。 如果此组件具有 M P 状态集,则 P 状态集索引范围为 0 到 M-1。 PEP 之前指定了响应 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知的 P 状态集数。
Flags
一组输入标志。 当前没有为此成员定义任何标志位,该成员始终为零。
Unit
一个 PEP_PERF_STATE_UNIT 枚举值,该值指示此 P 状态集的值是否以赫茨(频率单位)或每秒位(带宽单位)表示。
Type
一个 PEP_PERF_STATE_TYPE 枚举值,该值指示此 P 状态集的性能值是表示为离散值列表还是以连续值范围表示。
Discrete
如果 Type == PepPerfStateTypeDiscrete
,请使用此结构。
Discrete.Count
此 P 状态集中的离散性能值数。
Range
如果 Type == PepPerfStateTypeRange
,请使用此结构。
Range.Minimum
此 P 状态集的性能值范围内的最小值。 此值以 单位 成员指示的度量单位表示。
Range.Maximum
此 P 状态集的性能值范围内的最大值。 此值以 单位 成员指示的度量单位表示。
言论
PEP_DPM_QUERY_COMPONENT_PERF_SET 通知使用此结构。 发送此通知时,DeviceHandle、组件、设置和 标志 成员包含 Windows 电源管理框架(PoFx)提供的输入值。 离散 成员或 Range 成员包含 PEP 写入结构以响应通知的输出值。
未命名的联合包含此 P 状态集中的离散性能值数或此 P 状态集中的值范围。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 从 Windows 10 开始支持。 |
标头 | pepfx.h (include Pep_x.h) |