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)

另请参阅