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

  • Статья

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

Синтаксис

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

Члены

[in] DeviceHandle

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

[in] Component

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

[in] Set

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

[in, NameSize

На входных данных — размер (в байтах) буфера, на который указывает элемент Name . Если name имеет значение NULL, peP перезаписывает входное значение NameSize размером буфера, необходимым для строки имени.

[in] Name

Указатель на выходной буфер. PEP записывает имя P-состояния в этот буфер. Имя хранится в виде строки с расширенным символом, заканчивающейся нулевым значением. Элемент Name имеет значение NULL, если платформе управления питанием Windows (PoFx) необходимо определить, насколько велик буфер, выделяемый для строки имени. Если значение Name не равно NULL, буфер должен быть достаточно большим, чтобы содержать всю строку, включая завершающий символ NULL.

Комментарии

Эта структура используется в уведомлении PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME . Элементы DeviceHandle, Component и Set структуры содержат входные значения, предоставляемые PoFx при отправке этого уведомления. Если элемент Name не равен NULL, PEP записывает строку в буфер, на который указывает имя. Если name имеет значение NULL, PEP записывает требуемый размер буфера в элемент NameSize .

Строка, которую PEP записывает в выходной буфер, должна содержать описательное имя для набора P-состояний. Это имя предназначено для упрощения понимания записей журнала и диагностических сообщений.

Требования

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

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

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE