структура 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

Для наборов, представляющих дискретное количество состояний производительности (то есть, где элементОм Type является PoFxPerfStateTypeDiscrete), эта вложенная структура описывает состояния.

Discrete.Count

Количество состояний производительности в наборе.

Discrete.States

Указатель на массив PO_FX_PERF_STATE . Длина этого массива определяется элементом Count . Каждый элемент массива описывает одно состояние питания в наборе.

Range

Для наборов, представляющих непрерывное распределение состояний производительности (то есть, где элементОм Type является PoFxPerfStateTypeRange), эта вложенная структура описывает минимальное и максимальное значение диапазона состояний производительности.

Range.Minimum

Минимальное значение состояния производительности.

Range.Maximum

Максимальное значение состояния производительности.

Комментарии

Когда драйвер устройства вызывает подпрограмму PoFxRegisterComponentPerfStates для регистрации компонента для поддержки состояния производительности с помощью платформы управления питанием (PoFx), драйвер может предоставить PO_FX_COMPONENT_PERF_INFO структуру, описывающую наборы состояний производительности, поддерживаемые компонентом. Элемент PerfStateSets структуры PO_FX_COMPONENT_PERF_INFO содержит массив PO_FX_COMPONENT_PERF_SET структур, представляющих поддерживаемые состояния производительности.

Ожидается, что большинство драйверов определяют единый набор состояний производительности для каждого компонента. Например, драйвер может определить один набор состояний производительности для управления частотой часов для компонента. Однако некоторым драйверам может потребоваться определить несколько наборов состояний производительности для управления несколькими измерениями состояний производительности для компонента. Например, драйвер может определить два набора состояний производительности для управления тактовой частотой и пропускной способностью шины.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 10.
Верхняя часть wdm.h (включая Wudfwdm.h)

См. также раздел

Управление состоянием производительности устройства

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates