Función PerfQueryCounterInfo (perflib.h)

  • Artículo

Obtiene las especificaciones de contador de la consulta especificada.

Sintaxis

ULONG PerfQueryCounterInfo(
  [in]            HANDLE                   hQuery,
  [out, optional] PPERF_COUNTER_IDENTIFIER pCounters,
                  DWORD                    cbCounters,
  [out]           LPDWORD                  pcbCountersActual
);

Parámetros

[in] hQuery

Identificador de la consulta para la que desea obtener las especificaciones del contador.

[out, optional] pCounters

Puntero a un búfer lo suficientemente grande como para contener la cantidad de datos que especifica el parámetro cbCounters , en bytes. Puede ser NULL si cbCounters es 0.

cbCounters

Tamaño del búfer de pCounters , en bytes.

[out] pcbCountersActual

El tamaño del búfer realmente necesario para obtener las especificaciones del contador. El significado depende del valor que la función

Devuelve.

Valor devuelto de función Significado de pcbCountersActual
ERROR_SUCCESS Número de

bytes de información sobre las especificaciones de contador que la función almacena en el búfer especificado por pCounters .
ERROR_NOT_ENOUGH_MEMORY The

tamaño del búfer necesario para almacenar la información sobre las especificaciones del contador, en bytes. Ampliar el búfer al necesario

size y vuelva a llamar a la función.
Otros El valor no está definido y no se debe usar.

Valor devuelto

Código devuelto Descripción
ERROR_SUCCESS
 La función almacenó correctamente toda la información sobre las especificaciones del contador en el búfer especificado por pCounters . El valor que pcbCountersActual apunta a indica la cantidad de información almacenada realmente en el búfer, en bytes.
ERROR_NOT_ENOUGH_MEMORY
 El búfer especificado por pCounters no era lo suficientemente grande como para almacenar toda la información sobre las especificaciones del contador. El valor que pcbCountersActual apunta a indica el tamaño del búfer necesario para almacenar toda la información. Ampliar el búfer al necesario

size y vuelva a llamar a la función.
 

Para otros tipos de errores, el valor devuelto es un código de error del sistema.

Comentarios

La información sobre las especificaciones del contador se escribe en el búfer que pCounters especifica como una secuencia de bloques de PERF_COUNTER_IDENTIFIER . Tamaño en bytes de

la secuencia de bloques se escribe en pcbCountersActual. Cada bloque de PERF_COUNTER_IDENTIFIER consta de

de una estructura de PERF_COUNTER_IDENTIFIER , seguida opcionalmente de un UTF-16LE terminado en null

nombre de instancia, seguido de relleno para que el tamaño del

PERF_COUNTER_IDENTIFIER bloque es un múltiplo de 8 bytes. El tamaño de cada bloque, incluida la estructura de PERF_COUNTER_IDENTIFIER , el nombre de instancia y el relleno, viene determinado por el miembro Size de la estructura PERF_COUNTER_IDENTIFIER , que será un múltiplo de 8 bytes.

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]
Plataforma de destino Windows
Encabezado perflib.h
Library AdvAPI32.lib
Archivo DLL AdvAPI32.dll

Consulte también

PERF_COUNTER_IDENTIFIER