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

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

  • Статья

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

Синтаксис

typedef struct _PERF_COUNTERSET_REG_INFO {
  GUID  CounterSetGuid;
  ULONG CounterSetType;
  ULONG DetailLevel;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_REG_INFO, *PPERF_COUNTERSET_REG_INFO;

Члены

CounterSetGuid

Уникальный идентификатор набора счетчиков.

CounterSetType

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

DetailLevel

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

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

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

NumCounters

Количество PERF_COUNTER_REG_INFO структур в этом блоке PERF_COUNTERSET_REG_INFO .

InstanceType

Указывает, допустимо ли для набора счетчиков использование нескольких экземпляров, например, процессов или физических дисков, или одного экземпляра, например, памяти.

Ниже приведены возможные типы экземпляров.

Значение Значение
PERF_COUNTERSET_SINGLE_INSTANCE
 Набор счетчиков содержит счетчики с единственным экземпляром, например, счетчик объема физической памяти.
PERF_COUNTERSET_MULTI_INSTANCES
 Набор счетчиков содержит многоэкземплярные счетчики, например, счетчик для измерения среднего числа операций дискового ввода-вывода для процесса.
PERF_COUNTERSET_SINGLE_AGGREGATE
 Набор счетчиков содержит счетчики с единственным экземпляром, статистические значения которых извлекаются из одного или более источников. Например, счетчик в наборе счетчиков данного типа может получать число операций чтения для каждого из трех жестких дисков компьютера и суммировать эти значения.
PERF_COUNTERSET_MULTI_AGGREGATE
 Набор счетчиков содержит многоэкземплярные счетчики, статистические значения которых извлекаются из всех экземпляров счетчика. Например, счетчик в этом типе набора счетчиков может получить общее время выполнения потока для всех потоков в многопотоковом приложении и суммирует их значения.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY
 Разница между этим типом и PERF_COUNTERSET_SINGLE_AGGREGATE заключается в том, что этот тип набора счетчиков хранит все значения счетчиков за время существования приложения-получателя (значение счетчика кэшируется после времени существования счетчика). Например, если один из жестких дисков в приведенном выше примере статистической обработки станет недоступным, общее количество байтов, считанных этим диском, по-прежнему будет доступно и использовано для вычисления статистического значения.
PERF_COUNTERSET_INSTANCE_AGGREGATE
 Не реализован.

Комментарии

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

Требования

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