Función KeQueryHardwareCounterConfiguration (ntddk.h)

La rutina KeQueryHardwareCounterConfiguration consulta el sistema operativo para ver la lista de contadores de hardware que se van a usar para la generación de perfiles de subprocesos.

Sintaxis

NTSTATUS KeQueryHardwareCounterConfiguration(
  [out] PHARDWARE_COUNTER CounterArray,
  [in]  ULONG             MaximumCount,
  [out] PULONG            Count
);

Parámetros

[out] CounterArray

Puntero a un búfer asignado por el autor de la llamada en el que la rutina escribe una matriz de elementos de tipo HARDWARE_COUNTER. Cada elemento de matriz es una estructura que contiene información sobre un contador de hardware. La matriz contiene un elemento para cada contador de hardware que se asigna a la generación de perfiles de subprocesos. Si se produce un error en la rutina, no escribe nada en este búfer.

[in] MaximumCount

Especifica el número máximo de elementos a los que la rutina puede escribir en el búfer al que apunta el parámetro CounterArray . El tamaño del búfer asignado por el autor de la llamada debe tener al menos el tamaño maximumCount * de (HARDWARE_COUNTER) bytes.

[out] Count

Puntero a una ubicación en la que la rutina escribe el número de elementos de matriz que ha escrito en el búfer al que apunta el parámetro CounterArray . Si la longitud del búfer especificada por MaximumCount no es lo suficientemente grande como para contener toda la matriz, la rutina escribe la longitud necesaria en *Count y devuelve STATUS_BUFFER_TOO_SMALL.

Valor devuelto

KeQueryHardwareCounterConfiguration devuelve STATUS_SUCCESS si la llamada se realiza correctamente. Entre los valores devueltos de error posibles se incluyen los siguientes:

Comentarios

En Windows 7, esta rutina solo se implementa para las arquitecturas basadas en x86, x64 y itanium. Si el autor de la llamada se ejecuta en una arquitectura de procesador que no se admite, la rutina devuelve STATUS_NOT_IMPLEMENTED.

Para establecer la configuración del contador de hardware que se va a usar para la generación de perfiles de subprocesos, llame a la rutina KeSetHardwareCounterConfiguration .

Requisitos

Consulte también

HARDWARE_COUNTER

KeSetHardwareCounterConfiguration