estructura de PERF_COUNTER_REG_INFO (perflib.h)

  • Artículo

Proporciona información de registro sobre un contador de rendimiento.

Sintaxis

typedef struct _PERF_COUNTER_REG_INFO {
  ULONG     CounterId;
  ULONG     Type;
  ULONGLONG Attrib;
  ULONG     DetailLevel;
  LONG      DefaultScale;
  ULONG     BaseCounterId;
  ULONG     PerfTimeId;
  ULONG     PerfFreqId;
  ULONG     MultiId;
  ULONG     AggregateFunc;
  ULONG     Reserved;
} PERF_COUNTER_REG_INFO, *PPERF_COUNTER_REG_INFO;

Members

CounterId

Identificador único del contador de rendimiento dentro del conjunto de contadores. Un conjunto de contadores puede contener un máximo de 64 000 contadores de rendimiento.

Type

Tipo del contador de rendimiento. Para obtener información sobre los tipos de contador predefinidos, vea la sección Tipos de contadores del Kit de implementación de Windows Server 2003. Los consumidores usan el tipo de contador para determinar cómo calcular y mostrar el valor del contador. Los proveedores deben limitar su elección de tipos de contadores a la lista predefinida.

Los valores posibles son:

PERF_100NSEC_MULTI_TIMER

PERF_100NSEC_MULTI_TIMER_II

PERF_100NSEC_TIMER

PERF_100NSEC_TIMER_INV

PERF_AVERAGE_BASE

PERF_AVERAGE_BULK

PERF_AVERAGE_TIMER

PERF_COUNTER_100NS_QUEUELEN_TYPE

PERF_COUNTER_BULK_COUNT

PERF_COUNTER_COUNTER

PERF_COUNTER_DELTA

PERF_COUNTER_LARGE_DELTA

PERF_COUNTER_LARGE_QUEUELEN_TYPE

PERF_COUNTER_LARGE_RAWCOUNT

PERF_COUNTER_LARGE_RAWCOUNT_HEX

PERF_COUNTER_MULTI_TIMER

PERF_COUNTER_MULTI_TIMER_INV

PERF_COUNTER_OBJ_QUEUELEN_TYPE

PERF_COUNTER_RAWCOUNT

PERF_COUNTER_RAWCOUNT_HEX

PERF_COUNTER_TEXT

PERF_COUNTER_TIMER

PERF_COUNTER_TIMER_INV

PERF_ELAPSED_TIME

PERF_LARGE_RAW_BASE

PERF_OBJ_TIME_TIMER

PERF_PRECISION_100NS_TIMER

PERF_PRECISION_TIMER

PERF_PRECISION_OBJECT_TIMER

PERF_RAW_BASE

PERF_RAW_FRACTION

PERF_SAMPLE_COUNTER

PERF_SAMPLE_FRACTION

Attrib

Uno o varios atributos que indican cómo mostrar este contador.

Los valores posibles son:

Valor Significado
PERF_ATTRIB_BY_REFERENCE
 Recupere el valor del contador por referencia en lugar de por valor.
PERF_ATTRIB_NO_DISPLAYABLE
 No muestre el valor del contador.
PERF_ATTRIB_NO_GROUP_SEPARATOR
 No use separadores de dígitos al mostrar el valor del contador.
PERF_ATTRIB_DISPLAY_AS_REAL
 Muestra el valor del contador como un valor real.
PERF_ATTRIB_DISPLAY_AS_HEX
 Muestra el valor del contador como un número hexadecimal.
 

Los atributos PERF_ATTRIB_NO_GROUP_SEPARATOR, PERF_ATTRIB_DISPLAY_AS_REAL y PERF_ATTRIB_DISPLAY_AS_HEX no son mutuamente excluyentes. Si especifica los tres atributos, la prioridad se asigna a los atributos en el orden especificado.

DetailLevel

Audiencia de destino para el contador.

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.

DefaultScale

Factor de escalado que se va a aplicar al valor del contador de rendimiento sin procesar. Los valores válidos van de –10 a 10. Cero si no se aplica ninguna escala. Si este valor es cero, el valor de escala es 1; si este valor es 1, el valor de escala es 10; si este valor es –1, el valor de escala es .10; y así sucesivamente. El valor escalado del contador de rendimiento es igual al valor sin procesar del contador de rendimiento multiplicado por 10 elevado a la potencia que especifica el miembro DefaultScale .

BaseCounterId

Identificador de contador del contador base. 0xFFFFFFFF indica que no hay ningún contador base.

PerfTimeId

Identificador de contador del contador de rendimiento. 0xFFFFFFFF indica que no hay ningún contador de rendimiento.

PerfFreqId

Identificador de contador del contador de frecuencia. 0xFFFFFFFF indica que no hay ningún contador de frecuencia.

MultiId

Identificador de contador del contador múltiple. 0xFFFFFFFF indica que no hay ningún contador múltiple.

AggregateFunc

Función de agregación que el cliente debe aplicar al contador si

contador establecido en el que pertenece el contador es de tipo Global Aggregate, Multiple

Agregado de instancia o Historial global de agregados. El cliente especifica las instancias de contador en las que se realiza la agregación si el tipo de conjunto de contadores

es agregado de varias instancias; de lo contrario, el cliente debe agregar valores.

en todas las instancias del conjunto de contadores. Uno de los siguientes valores debe ser :

Especificado.

Valor Significado
PERF_AGGREGATE_UNDEFINED
 Sin definir.
PERF_AGGREGATE_TOTAL
 Suma de los valores de las instancias de contador devueltas.
PERF_AGGREGATE_AVG
 Promedio de los valores de las instancias de contador devueltas.
PERF_AGGREGATE_MIN
 Valor mínimo de los valores de instancia de contador devueltos.
PERF_AGGREGATE_MAX
Valor máximo de los valores de instancia de contador devueltos.

Reserved

Reservado.

Comentarios

La función PerfQueryCounterSetRegistrationInfo denominada con el parámetro requestCode establecido en PERF_REG_COUNTERSET_STRUCT obtiene un bloque PERF_COUNTERSET_REG_INFO que contiene una o varias estructuras PERF_COUNTER_REG_INFO .

La función PerfQueryCounterSetRegistrationInfo denominada con el parámetro requestCode establecido en PERF_REG_COUNTER_STRUCT obtiene una estructura de PERF_COUNTER_REG_INFO .

Requisitos

   
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

PERF_COUNTERSET_REG_INFO

PerfQueryCounterSetRegistrationInfo