Función PerfQueryCounterData (perflib.h)

Obtiene los valores de los contadores de rendimiento que coinciden con las especificaciones de contador de la consulta especificada.

Sintaxis

ULONG PerfQueryCounterData(
  [in]            HANDLE            hQuery,
  [out, optional] PPERF_DATA_HEADER pCounterBlock,
                  DWORD             cbCounterBlock,
  [out]           LPDWORD           pcbCounterBlockActual
);

Parámetros

[in] hQuery

Identificador de una consulta para las especificaciones de contador de los contadores de rendimiento para los que desea obtener los valores.

[out, optional] pCounterBlock

Puntero a un búfer que tiene espacio suficiente para recibir la cantidad de datos que especifica el parámetro cbCounterBlock , en bytes. Puede ser NULL si

cbCounterBlock es 0.

cbCounterBlock

Tamaño del búfer que especifica el parámetro pCounterBlock , en bytes.

[out] pcbCounterBlockActual

El tamaño del búfer realmente necesario para obtener los valores del contador de rendimiento. El significado depende del valor que la función

Devuelve.

Valor devuelto de función	Significado de pcbCounterBlockActual
ERROR_SUCCESS	Número de bytes de valores de contador de rendimiento que la función almacena en el búfer que pCounterBlock especificó.
ERROR_NOT_ENOUGH_MEMORY	The tamaño del búfer necesario para almacenar los valores del contador de rendimiento, 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 todos los valores de contador de rendimiento solicitados en el búfer que pCounterBlock especificó. El valor que pcbCounterBlockActual apunta a indica la cantidad de información almacenada realmente en el búfer, en bytes.
ERROR_NOT_ENOUGH_MEMORY	El búfer que pCounterBlock especificó no era lo suficientemente grande como para almacenar todos los valores de contador de rendimiento solicitados. El valor que pcbCounterBlockActual 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 los valores del contador de rendimiento se escribe en el búfer que pCounterBlock especifica como un bloque PERF_DATA_HEADER , que consta de PERF_DATA_HEADER estructura seguida de una secuencia de bloques de PERF_COUNTER_HEADER .

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

Consulte también

PERF_COUNTER_HEADER

PERF_DATA_HEADER