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

структура PERF_COUNTER_DEFINITION (winperf.h)

  • Статья

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

Синтаксис

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

Члены

ByteLength

Размер этой структуры в байтах.

CounterNameTitleIndex

Индекс имени счетчика в базе данных заголовков. Дополнительные сведения об использовании индекса для получения имени счетчика см. в разделе Получение имен счетчиков и текста справки.

Чтобы задать это значение, поставщики добавляют значение смещения счетчика, определенное в файле символов, в значение реестра First Counter . Дополнительные сведения см. в разделах Добавление имен и описаний счетчиков в реестр и Реализация функции OpenPerformanceData.

Это значение должно быть равно нулю, если счетчик является базовым (CounterType включает флаг PERF_COUNTER_BASE).

CounterNameTitle

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

CounterHelpTitleIndex

Индекс на текст справки счетчика в базе данных заголовков. Дополнительные сведения об использовании индекса для получения текста справки счетчика см. в разделе Получение имен счетчиков и текста справки.

Чтобы задать это значение, поставщики добавляют значение смещения счетчика, определенное в файле символов, в значение реестра Первой справки . Дополнительные сведения см. в разделах Добавление имен и описаний счетчиков в реестр и Реализация функции OpenPerformanceData.

Это значение должно быть равно нулю, если счетчик является базовым (CounterType включает флаг PERF_COUNTER_BASE).

CounterHelpTitle

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

DefaultScale

Коэффициент масштабирования, используемый при создании графа значения счетчика. Допустимые значения варьируются от –7 до 7 (значения соответствуют 0,0000001–10000000). Если это значение равно нулю, масштаб равно 1; Если это значение равно 1, то масштаб равно 10; Если это значение равно –1, масштаб равно 0,10; и так далее.

DetailLevel

Уровень детализации счетчика. Потребители используют это значение для управления сложностью отображения. Этот элемент может иметь одно из следующих значений.

Уровень детализации Значение
PERF_DETAIL_NOVICE
 Данные счетчика предоставляются для всех пользователей.
PERF_DETAIL_ADVANCED
 Данные счетчика предоставляются для опытных пользователей.
PERF_DETAIL_EXPERT
 Данные счетчика предоставляются для опытных пользователей.
PERF_DETAIL_WIZARD
 Данные счетчика предоставляются для системных конструкторов.

CounterType

Тип счетчика. Список стандартных типов счетчиков см. в разделе Типы счетчиков комплекта развертывания Windows Server 2003. Потребители используют тип счетчика для определения способа вычисления и отображения значения счетчика. Поставщики должны ограничить выбор типов счетчиков предопределенным списком.

CounterSize

Размер счетчика в байтах.

В настоящее время для предоставления значений счетчиков используются только DWORD (4 байта) и ULONGLONG (8 байт).

CounterOffset

Смещение от начала структуры PERF_COUNTER_BLOCK до первого байта этого счетчика. Расположение структуры PERF_COUNTER_BLOCK в блоке PERF_OBJECT_TYPE зависит от того, содержит ли объект экземпляры. Дополнительные сведения см. в разделе Формат данных производительности.

Обратите внимание, что несколько счетчиков могут использовать одни и те же необработанные данные и указывать на одно и то же смещение в блоке PERF_COUNTER_BLOCK .

Комментарии

Структура PERF_OBJECT_TYPE содержит один или несколько счетчиков. Эта структура определяет каждый счетчик и присваивает смещение его значению. Эти структуры соответствуют PERF_OBJECT_TYPE структуре в памяти. Дополнительные сведения см. в разделе Формат данных производительности.

Поставщики должны предоставлять свои счетчики в одном порядке каждый раз при запросе счетчиков. Если счетчик использует базовый счетчик при вычислении (тип счетчика включает флаг PERF_COUNTER_FRACTION ), базовый счетчик должен следовать этому счетчику в списке счетчиков. Если тип счетчика включает флаг PERF_MULTI_COUNTER , то второе значение счетчика должно соответствовать значению этого счетчика в блоке PERF_COUNTER_BLOCK .

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winperf.h (включая Windows.h)

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

PERF_COUNTER_BLOCK

PERF_OBJECT_TYPE