структура 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 структуру, описывающую наборы состояний производительности, поддерживаемых компонентом. Элемент PerfStateSets структуры PO_FX_COMPONENT_PERF_INFO содержит массив структур PO_FX_COMPONENT_PERF_SET, представляющих поддерживаемые состояния производительности.

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

Требования

См. также

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

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates