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

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

  • Статья

Предоставляет сведения о регистрации счетчика производительности.

Синтаксис

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

Члены

CounterId

Уникальный идентификатор счетчика производительности в наборе счетчиков. Набор счетчиков может содержать не более 64 000 счетчиков производительности.

Type

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

Вы можете выбрать

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

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

Вы можете выбрать

Значение Значение
PERF_ATTRIB_BY_REFERENCE
 Получение значения счетчика по ссылке, а не по значению.
PERF_ATTRIB_NO_DISPLAYABLE
 Не отображать значение счетчика.
PERF_ATTRIB_NO_GROUP_SEPARATOR
 Не используйте разделители цифр при отображении значения счетчика.
PERF_ATTRIB_DISPLAY_AS_REAL
 Отображение значения счетчика в качестве реального значения.
PERF_ATTRIB_DISPLAY_AS_HEX
 Отображение значения счетчика в виде шестнадцатеричного числа.
 

Атрибуты PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL и PERF_ATTRIB_DISPLAY_AS_HEX не являются взаимоисключающими. Если указать все три атрибута, приоритет отдается атрибутам в указанном порядке.

DetailLevel

Целевая аудитория счетчика.

Вы можете выбрать

Значение Значение
PERF_DETAIL_NOVICE
 Счетчик можно отобразить для пользователя любого уровня.
PERF_DETAIL_ADVANCED
 Счетчик является сложным и должен отображаться только для опытных пользователей.

DefaultScale

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

BaseCounterId

Идентификатор базового счетчика. 0xFFFFFFFF указывает на отсутствие базового счетчика.

PerfTimeId

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

PerfFreqId

Идентификатор счетчика частоты. 0xFFFFFFFF указывает на отсутствие счетчика частоты.

MultiId

Идентификатор счетчика с несколькими счетчиками. 0xFFFFFFFF указывает на отсутствие нескольких счетчиков.

AggregateFunc

Агрегатная функция, к счетчику должна применяться клиент, если

набор счетчика, которому принадлежит счетчик, относится к типу Global Aggregate, Multiple

Агрегат экземпляра или глобальный журнал агрегатов. Клиент указывает экземпляры счетчика, в которых выполняется агрегирование, если тип набора счетчика

— это статистическая обработка нескольких экземпляров; в противном случае клиент должен агрегировать значения

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

Указанного.

Значение Значение
PERF_AGGREGATE_UNDEFINED
 Не определено.
PERF_AGGREGATE_TOTAL
 Сумма значений возвращаемых экземпляров счетчика.
PERF_AGGREGATE_AVG
 Среднее значение значений возвращаемых экземпляров счетчика.
PERF_AGGREGATE_MIN
 Минимальное значение возвращаемых значений экземпляра счетчика.
PERF_AGGREGATE_MAX
Максимальное значение возвращаемых значений экземпляра счетчика.

Reserved

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

Комментарии

Функция PerfQueryCounterSetRegistrationInfo , вызываемая с параметром requestCode , для PERF_REG_COUNTERSET_STRUCT получаетблок PERF_COUNTERSET_REG_INFO , содержащий одну или несколько PERF_COUNTER_REG_INFO структур.

Функция PerfQueryCounterSetRegistrationInfo , вызываемая с параметром requestCode , для PERF_REG_COUNTER_STRUCT получаетPERF_COUNTER_REG_INFO структуру.

Требования

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

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

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo