Compartir a través de

Función PerfQueryCounterData (perflib.h)

  • Artículo

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