pepfx.h) (PEP_QUERY_COMPONENT_PERF_SET 结构

  • 项目

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 之前指定了响应 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 状态集的性能值范围内的最小值。 此值以 Unit 成员指示的度量单位表示。

Range.Maximum

此 P 状态集的性能值范围内的最大值。 此值以 Unit 成员指示的度量单位表示。

注解

此结构由 PEP_DPM_QUERY_COMPONENT_PERF_SET 通知使用。 发送此通知时， DeviceHandle、 Component、 Set 和 Flags 成员包含 Windows 电源管理框架 (PoFx) 提供的输入值。 离散成员或 Range 成员包含 PEP 写入结构以响应通知的输出值。

未命名的联合包含此 P 状态集中的离散性能值的数量，或此 P 状态集中的值范围。

要求

要求 值
最低受支持的客户端 从 Windows 10 开始支持。
标头 pepfx.h (包括 Pep_x.h)

另请参阅