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

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

[in] Set

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

[in, NameSize

В входных данных размер буфера в байтах, на который указывает элемент Name. Если имя имеет значение NULL, PEP перезаписывает входное значение NameSize размером буфера, необходимым для строки имени.

[in] Name

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

Замечания

Эта структура используется уведомлением PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME. DeviceHandle, компонент и Задать элементы структуры содержат входные значения, предоставленные PoFx при отправке этого уведомления. Если элемент имени не имеет значения NULL, PEP записывает строку в буфер, на который указывает Имя. Если имя имеет значение 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