estructura PERF_COUNTERSET_REG_INFO (perflib.h)

  • Artículo

Contiene información sobre el bloque PERF_COUNTERSET_REG_INFO que contiene la estructura. Un bloque de PERF_COUNTERSET_REG_INFO proporciona información de registro para un conjunto de contadores y los contadores de rendimiento que contiene, y consta de una estructura de PERF_COUNTERSET_REG_INFO inmediatamente seguida de un conjunto PERF_COUNTER_REG_INFO estructuras que corresponden a los contadores de rendimiento del conjunto de contadores.

Sintaxis

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

Miembros

CounterSetGuid

Identificador único del conjunto de contadores.

CounterSetType

Reservado.

DetailLevel

Audiencia de destino de los contadores del conjunto de contadores.

Los valores posibles son:

Valor Significado
PERF_DETAIL_NOVICE
 Puede mostrar el contador en cualquier nivel de usuario.
PERF_DETAIL_ADVANCED
 El contador es complicado y solo se debe mostrar a los usuarios avanzados.

NumCounters

Número de estructuras de PERF_COUNTER_REG_INFO en este bloque de PERF_COUNTERSET_REG_INFO .

InstanceType

Especifica si el conjunto de contadores permite varias instancias, como procesos y discos físicos, o una única instancia, como la memoria.

A continuación se muestran los tipos de instancia posibles.

Valor Significado
PERF_COUNTERSET_SINGLE_INSTANCE
 El conjunto de contadores tiene contadores de una instancia; por ejemplo, un contador que mide la memoria física.
PERF_COUNTERSET_MULTI_INSTANCES
 El conjunto de contadores tiene contadores de varias instancias; por ejemplo, un contador que mide el promedio de E/S en un disco en relación a un proceso.
PERF_COUNTERSET_SINGLE_AGGREGATE
 El conjunto contiene contadores de una única instancia cuyo valor agregado se obtiene de uno o varios orígenes. Por ejemplo, un contador de este tipo de conjunto de contadores podría obtener el número de lecturas de cada uno de los tres discos duros del equipo y sumar sus valores.
PERF_COUNTERSET_MULTI_AGGREGATE
 El conjunto de contadores contiene contadores de varias instancias cuyo valor agregado se obtiene de todas las instancias del contador. Por ejemplo, un contador de este tipo de conjunto de contadores podría obtener el tiempo total de ejecución de subprocesos para todos los subprocesos de una aplicación multiproceso y sumar sus valores.
PERF_COUNTERSET_SINGLE_AGGREGATE_HISTORY
 La diferencia entre este tipo y PERF_COUNTERSET_SINGLE_AGGREGATE es que este tipo de conjunto de contadores almacena todos los valores de contador durante la vigencia de la aplicación consumidor (el valor del contador se almacena en caché más allá de la duración del contador). Por ejemplo, si uno de los discos duros del ejemplo de agregado único anterior dejara de estar disponible, el total de bytes leídos por ese disco seguirá estando disponible y se usaría para calcular el valor agregado.
PERF_COUNTERSET_INSTANCE_AGGREGATE
 Sin implementar.

Comentarios

La función PerfQueryCounterSetRegistrationInfo denominada con el parámetro requestCode establecido en PERF_REG_COUNTERSET_STRUCT obtiene un bloque de PERF_COUNTERSET_REG_INFO .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1607 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Encabezado perflib.h