структура PEP_QUERY_COMPONENT_PERF_SET (pepfx.h)

  • Статья

Структура PEP_QUERY_COMPONENT_PERF_SET содержит сведения о запросе о наборе значений состояния производительности (P-состояния) для компонента.

Синтаксис

typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
  PEPHANDLE           DeviceHandle;
  ULONG               Component;
  ULONG               Set;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG Count;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;

Члены

DeviceHandle

Значение PEPHANDLE , идентифицирующее устройство. PeP предоставил этот дескриптор в ответ на предыдущее уведомление PEP_DPM_REGISTER_DEVICE .

Component

Индекс, идентифицирующий компонент. Этот элемент является индексом массива Components в структуре PEP_DEVICE_REGISTER_V2 , которая ранее была предоставлена PEP в ответ на уведомление PEP_DPM_REGISTER_DEVICE для этого устройства. Если массив Components содержит N элементов, индексы компонентов варьируются от 0 до N–1.

Set

Индекс, определяющий этот набор P-состояний. Если этот компонент имеет наборы состояний M P, индексы набора P-состояний варьируются от 0 до M–1. В PEP ранее указывалось количество наборов P-состояний в ответ на уведомление PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .

Flags

Набор входных флагов. В настоящее время для этого элемента не определены биты флагов, что всегда равно нулю.

Unit

Значение перечисления PEP_PERF_STATE_UNIT , указывающее, выражены ли значения для этого набора P-состояний в герцах (единицах частоты) или битах в секунду (единицы пропускной способности).

Type

Значение перечисления PEP_PERF_STATE_TYPE , указывающее, выражаются ли значения производительности для этого набора P-состояний в виде списка дискретных значений или в виде непрерывного диапазона значений.

Discrete

Используйте эту структуру, если Type == PepPerfStateTypeDiscrete.

Discrete.Count

Количество дискретных значений производительности в этом наборе P-состояний.

Range

Используйте эту структуру, если Type == PepPerfStateTypeRange.

Range.Minimum

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

Range.Maximum

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

Комментарии

Эта структура используется в уведомлении PEP_DPM_QUERY_COMPONENT_PERF_SET . Элементы DeviceHandle, Component, Set и Flags содержат входные значения, предоставляемые платформой управления питанием Windows (PoFx) при отправке этого уведомления. Дискретный элемент или элемент Range содержит выходное значение, которое PEP записывает в структуру в ответ на уведомление.

Неименованное объединение содержит либо количество дискретных значений производительности в этом наборе P-состояний, либо диапазон значений в этом наборе P-состояний.

Требования

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

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