estructura PERF_COUNTER_IDENTIFIER (perflib.h)

Contiene información sobre el bloque PERF_COUNTER_IDENTIFIER que contiene la estructura. Un bloque PERF_COUNTER_IDENTIFIER proporciona información sobre una especificación de contador de rendimiento y consta de los siguientes elementos en orden:

1. Estructura de PERF_COUNTER_IDENTIFIER
2. Cadena UTF-16LE terminada en NULL opcional que especifica el nombre de instancia.
3. Relleno según sea necesario para que el tamaño del bloque sea un múltiplo de 8 bytes.

Sintaxis

typedef struct _PERF_COUNTER_IDENTIFIER {
  GUID  CounterSetGuid;
  ULONG Status;
  ULONG Size;
  ULONG CounterId;
  ULONG InstanceId;
  ULONG Index;
  ULONG Reserved;
} PERF_COUNTER_IDENTIFIER, *PPERF_COUNTER_IDENTIFIER;

Miembros

CounterSetGuid

GUID del conjunto de contadores de rendimiento.

Status

Código de error que indica si la operación para agregar o eliminar un contador de rendimiento se realizó correctamente o no.

Size

Tamaño total del bloque de PERF_COUNTER_IDENTIFIER , en bytes. El tamaño total del bloque es la suma de los tamaños de la estructura PERF_COUNTER_IDENTIFIER , la cadena que especifica el nombre de instancia y el relleno.

CounterId

Identificador del contador de rendimiento. PERF_WILDCARD_COUNTER especifica todos los contadores.

InstanceId

Identificador de la instancia. Especifique 0xFFFFFFFF si no desea filtrar los resultados en función del identificador de instancia.

Index

Posición en la secuencia de PERF_COUNTER_IDENTIFIER bloques en los que se devuelven los datos de contador que corresponden a este bloque PERF_COUNTER_IDENTIFIER . Se establece por PerfQueryCounterInfo.

Reserved

Reservado.

Comentarios

Al especificar un identificador de conjunto de contadores para un conjunto de contadores de instancia única, no debe especificar el nombre de instancia en los datos adicionales del bloque PERF_COUNTER_IDENTIFIER . El tamaño del bloque PERF_COUNTER_IDENTIFIER debe ser el tamaño de la estructura PERF_COUNTER_IDENTIFIER .

Por otro lado, al especificar un identificador de conjunto de contadores para un conjunto de contadores de varias instancias, debe especificar el nombre de instancia en los datos adicionales del bloque PERF_COUNTER_IDENTIFIER . El identificador no es válido, a menos que el tamaño del bloque de PERF_COUNTER_IDENTIFIER sea mayor que el tamaño de la estructura de PERF_COUNTER_IDENTIFIER . Si no desea filtrar los conjuntos de contadores según el nombre de la instancia, use PERF_WILDCARD_INSTANCE como nombre de instancia.

Las funciones PerfAddCounters y PerfDeleteCounters aceptan una secuencia de bloques de PERF_COUNTER_IDENTIFIER para definir las especificaciones de contador que desea agregar o quitar de una consulta.

La función PerfQueryCounterInfo obtiene una secuencia de bloques de PERF_COUNTER_IDENTIFIER para indicar las especificaciones del contador en una consulta e indicar en el miembro Index el orden en el que la consulta obtiene los resultados.

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

Consulte también

PerfAddCounters

PerfDeleteCounters

PerfQueryCounterInfo