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数组的 指针。 此数组的长度由 Count 成员指定。 每个数组元素描述集中的一个电源状态。

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