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

структура PERF_COUNTER_IDENTIFIER (perflib.h)

  • Статья

Содержит сведения о блоке PERF_COUNTER_IDENTIFIER , который содержит структуру . Блок PERF_COUNTER_IDENTIFIER содержит сведения о спецификации счетчика производительности и состоит из следующих элементов по порядку:

  1. Структура PERF_COUNTER_IDENTIFIER
  2. Необязательная строка UTF-16LE, завершающаяся null, которая указывает имя экземпляра.
  3. Заполнение по мере необходимости, чтобы сделать размер блока кратным 8 байтам.

Синтаксис

typedef struct _PERF_COUNTER_IDENTIFIER {
  GUID  CounterSetGuid;
  ULONG Status;
  ULONG Size;
  ULONG CounterId;
  ULONG InstanceId;
  ULONG Index;
  ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;

Члены

CounterSetGuid

GUID набора счетчиков производительности.

Status

Код ошибки, указывающий, выполнена ли операция добавления или удаления счетчика производительности.

Size

Общий размер блока PERF_COUNTER_IDENTIFIER в байтах. Общий размер блока — это сумма размеров структуры PERF_COUNTER_IDENTIFIER , строка, указывающая имя экземпляра, и заполнение.

CounterId

Идентификатор счетчика производительности. PERF_WILDCARD_COUNTER указывает все счетчики.

InstanceId

Идентификатор экземпляра. Укажите 0xFFFFFFFF, если вы не хотите фильтровать результаты по идентификатору экземпляра.

Index

Позиция в последовательности блоков PERF_COUNTER_IDENTIFIER , в которой возвращаются данные счетчика, соответствующие этому PERF_COUNTER_IDENTIFIER блоку. Задано параметром PerfQueryCounterInfo.

Reserved

Зарезервировано.

Комментарии

При указании идентификатора набора счетчиков с одним экземпляром не следует указывать имя экземпляра в дополнительных данных блока PERF_COUNTER_IDENTIFIER . Размер блока PERF_COUNTER_IDENTIFIER должен соответствовать размеру структуры PERF_COUNTER_IDENTIFIER .

С другой стороны, при указании идентификатора набора счетчиков с несколькими экземплярами необходимо указать имя экземпляра в дополнительных данных блока PERF_COUNTER_IDENTIFIER . Идентификатор не считается допустимым, если размер блока PERF_COUNTER_IDENTIFIER не превышает размер PERF_COUNTER_IDENTIFIER структуры. Если вы не хотите фильтровать наборы счетчиков по имени экземпляра, используйте PERF_WILDCARD_INSTANCE в качестве имени экземпляра.

Функции PerfAddCounters и PerfDeleteCounters принимают последовательность блоков PERF_COUNTER_IDENTIFIER для определения спецификаций счетчиков, которые необходимо добавить или удалить из запроса.

Функция PerfQueryCounterInfo получает последовательность блоков PERF_COUNTER_IDENTIFIER , чтобы указать спецификации счетчика в запросе и указать в элементе Index порядок, в котором запрос получает результаты.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1607 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Верхняя часть perflib.h

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

PerfAddCounters

PerfDeleteCounters

PerfQueryCounterInfo