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


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

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

Set

Индекс, определяющий этот набор состояний P. Если этот компонент содержит наборы состояний M, индексы набора состояний 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. Это значение выражается в единицах измерения, указанных элементом единиц .

Range.Maximum

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

Замечания

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Поддерживается начиная с Windows 10.
заголовка pepfx.h (include Pep_x.h)

См. также