Compartir a través de

estructura PERF_COUNTER_DEFINITION (winperf.h)

  • Artículo

Describe un contador de rendimiento.

Sintaxis

typedef struct _PERF_COUNTER_DEFINITION {
  DWORD  ByteLength;
  DWORD  CounterNameTitleIndex;
#if ...
  DWORD  CounterNameTitle;
#else
  LPWSTR CounterNameTitle;
#endif
  DWORD  CounterHelpTitleIndex;
#if ...
  DWORD  CounterHelpTitle;
#else
  LPWSTR CounterHelpTitle;
#endif
  LONG   DefaultScale;
  DWORD  DetailLevel;
  DWORD  CounterType;
  DWORD  CounterSize;
  DWORD  CounterOffset;
} PERF_COUNTER_DEFINITION, *PPERF_COUNTER_DEFINITION;

Miembros

ByteLength

Tamaño de esta estructura, en bytes.

CounterNameTitleIndex

Índice del nombre del contador en la base de datos de título. Para obtener más información sobre cómo usar el índice para recuperar el nombre del contador, consulte Recuperación de nombres de contadores y texto de ayuda.

Para establecer este valor, los proveedores agregan el valor de desplazamiento del contador definido en su archivo de símbolos al valor del Registro First Counter . Para obtener más información, vea Agregar nombres y descripciones de contadores al Registro e Implementación de la función OpenPerformanceData.

Este valor debe ser cero si el contador es un contador base (CounterType incluye la marca PERF_COUNTER_BASE).

CounterNameTitle

Reservado.

CounterHelpTitleIndex

Indexe el texto de ayuda del contador en la base de datos de título. Para obtener más información sobre cómo usar el índice para recuperar el texto de ayuda del contador, consulte Recuperación de nombres de contadores y texto de ayuda.

Para establecer este valor, los proveedores agregan el valor de desplazamiento del contador definido en su archivo de símbolos al valor del Registro de Primera Ayuda . Para obtener más información, vea Agregar nombres y descripciones de contadores al Registro e Implementación de la función OpenPerformanceData.

Este valor debe ser cero si el contador es un contador base (CounterType incluye la marca PERF_COUNTER_BASE).

CounterHelpTitle

Reservado.

DefaultScale

Factor de escala que se va a usar al representar el valor del contador. Los valores válidos oscilan entre -7 y 7 (los valores corresponden a 0,0000001 a 10000000). 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.

DetailLevel

Nivel de detalle del contador. Los consumidores usan este valor para controlar la complejidad de la visualización. Este miembro puede ser uno de los valores siguientes.

Nivel de detalle Significado
PERF_DETAIL_NOVICE
 Los datos del contador se proporcionan para todos los usuarios.
PERF_DETAIL_ADVANCED
 Los datos del contador se proporcionan para los usuarios avanzados.
PERF_DETAIL_EXPERT
 Los datos del contador se proporcionan para los usuarios expertos.
PERF_DETAIL_WIZARD
 Los datos del contador se proporcionan para los diseñadores del sistema.

CounterType

Tipo de contador. Para obtener una lista de 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.

CounterSize

Tamaño del contador, en bytes.

Actualmente, solo se usan DWORD (4 bytes) y ULONGLONG (8 bytes) para proporcionar valores de contador.

CounterOffset

Desfase desde el principio de la estructura PERF_COUNTER_BLOCK hasta el primer byte de este contador. La ubicación de la estructura PERF_COUNTER_BLOCK dentro del bloque PERF_OBJECT_TYPE depende de si el objeto contiene instancias. Para obtener más información, consulte Formato de datos de rendimiento.

Tenga en cuenta que varios contadores pueden usar los mismos datos sin procesar y apuntar al mismo desplazamiento en el bloque PERF_COUNTER_BLOCK .

Comentarios

Una estructura PERF_OBJECT_TYPE contiene uno o varios contadores. Esta estructura define cada contador y proporciona el desplazamiento a su valor. Estas estructuras siguen la estructura PERF_OBJECT_TYPE en memoria. Para obtener más información, consulte Formato de datos de rendimiento.

Los proveedores deben proporcionar sus contadores en el mismo orden cada vez que se consultan sus contadores. Si el contador usa un contador base en su cálculo (el tipo de contador incluye la marca PERF_COUNTER_FRACTION ), el contador base debe seguir este contador en la lista de contadores. Si el tipo de contador incluye la marca PERF_MULTI_COUNTER , el segundo valor del contador debe seguir el valor de este contador en el bloque PERF_COUNTER_BLOCK .

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winperf.h (incluye Windows.h)

Consulte también

PERF_COUNTER_BLOCK

PERF_OBJECT_TYPE