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_INFOPerfStateSets 成员是 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)

另请参阅