структура PEP_COMPONENT_PERF_SET (pepfx.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

Минимальное значение в диапазоне. Это значение выражается в единицах, указанных элементом Unit .

Range.Maximum

Максимальное значение в диапазоне. Это значение выражается в единицах, указанных элементом Unit .

Комментарии

Неименованное объединение содержит значения измерения производительности для этого 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.
Верхняя часть pepfx.h (включая Pep_x.h)

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