Поделиться через

структура 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-состояния нет такой строки, для элемента Name задано значение 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).

Элемент PerfStateSetsPEP_COMPONENT_PERF_INFO является первым элементом в массиве структур 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 (include Pep_x.h)

См. также