PO_FX_COMPONENT_PERF_SET结构 (wdm.h)

PO_FX_COMPONENT_PERF_SET 结构表示设备中单个组件的性能状态集。

语法

typedef struct _PO_FX_COMPONENT_PERF_SET {
  UNICODE_STRING        Name;
  ULONGLONG             Flags;
  PO_FX_PERF_STATE_UNIT Unit;
  PO_FX_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG             Count;
      PPO_FX_PERF_STATE States;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;

成员

Name

用于描述性能状态集控制的组件属性的可选字符串。 例如,“时钟频率”或“内存带宽”。

Flags

设置为 0。 目前,没有为此成员定义任何标志。

Unit

一个 PO_FX_PERF_STATE_UNIT 值,该值指定由性能状态集控制的单元的类型。

Type

一个 PO_FX_PERF_STATE_TYPE 值,该值指定集中的性能状态类型(最小值和最大值之间的离散状态数或状态的连续分布)。

Discrete

对于表示离散数量的性能状态(即 类型 成员 PoFxPerfStateTypeDiscrete),此嵌套结构描述状态。

Discrete.Count

集中的性能状态数。

Discrete.States

指向 PO_FX_PERF_STATE 数组的指针。 此数组的长度由 计数 成员指定。 每个数组元素描述集中的一个电源状态。

Range

对于表示性能状态的持续分布(即 类型 成员 PoFxPerfStateTypeRange),此嵌套结构描述了性能状态范围的最小值和最大值。

Range.Minimum

最小性能状态值。

Range.Maximum

最大性能状态值。

言论

当设备驱动程序调用 PoFxRegisterComponentPerfStates 例程,以向电源管理框架(PoFx)注册性能状态支持组件时,驱动程序可以提供描述组件支持的性能状态集的 PO_FX_COMPONENT_PERF_INFO 结构。 PO_FX_COMPONENT_PERF_INFO 结构的 PerfStateSets 成员包含表示支持性能状态的 PO_FX_COMPONENT_PERF_SET 结构的数组。

大多数驱动程序应为每个组件定义一组性能状态。 例如,驱动程序可以定义一组性能状态来控制组件的时钟频率。 但是,某些驱动程序可能需要定义多个性能状态集来控制组件性能状态的多个维度。 例如,驱动程序可以定义两组性能状态来控制时钟频率和总线带宽。

要求

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

另请参阅

设备性能状态管理

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates