Compartir a través de


estructura PERF_COUNTERSET_INFO (perflib.h)

Define información sobre un conjunto de contadores que usa un proveedor. La herramienta CTRPP genera automáticamente esta estructura en función del esquema que especifique.

Sintaxis

typedef struct _PERF_COUNTERSET_INFO {
  GUID  CounterSetGuid;
  GUID  ProviderGuid;
  ULONG NumCounters;
  ULONG InstanceType;
} PERF_COUNTERSET_INFO, *PPERF_COUNTERSET_INFO;

Members

CounterSetGuid

GUID que identifica de forma única el conjunto de contadores. El atributo guid del elemento counterSet contiene el GUID.

ProviderGuid

GUID que identifica de forma única el proveedor que admite el conjunto de contadores. El atributo providerGuid del elemento provider contiene el GUID.

NumCounters

Número de contadores del conjunto de contadores. Vea la sección Comentarios.

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 posibles tipos de instancia.

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 de 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 no estaba disponible, el total de bytes leídos por ese disco seguiría estando disponible y se usaría para calcular el valor agregado.
PERF_COUNTERSET_INSTANCE_AGGREGATE
Este tipo es similar a PERF_COUNTERSET_MULTI_AGGREGATE, salvo que, en lugar de agregar todos los datos de instancia a una instancia agregada (_Total), agregará datos de contador de instancias del mismo nombre.

Por ejemplo, si varios procesos de proveedor contenían instancias denominadas IExplore, PERF_COUNTERSET_MULTIPLE y PERF_COUNTERSET_MULTI_AGGREGATE CounterSet mostrarán varias instancias de IExplore (IExplore, IExplore#1, IExplore#2, etc.); sin embargo, un tipo de instancia de PERF_COUNTERSET_INSTANCE_AGGREGATE solo publicará una instancia de IExplore con datos de contador agregados de todas las instancias denominadas IExplore.

Windows Vista: Este tipo no está disponible.

Comentarios

El bloque de memoria de esta estructura también contiene una o varias estructuras de PERF_COUNTER_INFO . El miembro NumCounter determina el número de estructuras de PERF_COUNTER_INFO que siguen esta estructura en memoria.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado perflib.h

Consulte también

PERF_COUNTER_INFO

PerfSetCounterSetInfo