структура PEP_QUERY_COMPONENT_PERF_SET_NAME (pep_x.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-состояния в этот буфер. Имя хранится в виде строки с расширенным символом, заканчивающейся null. Элемент 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-состояния. Это имя предназначено для упрощения понимания записей журнала и диагностических сообщений.

Требования

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

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE