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:
- Estructura de PERF_COUNTER_IDENTIFIER
- Cadena UTF-16LE terminada en NULL opcional que especifica el nombre de instancia.
- 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 |