Функция KeQueryHardwareCounterConfiguration (ntddk.h)

KeQueryHardwareCounterConfiguration подпрограммы запрашивает операционную систему, чтобы список аппаратных счетчиков, используемых для профилирования потоков.

Синтаксис

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

Параметры

[out] CounterArray

Указатель на выделенный вызывающим буфером, в который подпрограмма записывает массив элементов типа HARDWARE_COUNTER. Каждый элемент массива — это структура, содержащая сведения о счетчике оборудования. Массив содержит один элемент для каждого счетчика оборудования, назначенного профилированию потоков. Если подпрограмма завершается ошибкой, она не записывает ничего в этот буфер.

[in] MaximumCount

Указывает максимальное количество элементов, которые подпрограмма может записывать в буфер, на который указывает параметр CounterArray. Размер выделенного буфера вызывающего объекта должен быть по крайней мере * максимальный размер(HARDWARE_COUNTER) байтов.

[out] Count

Указатель на расположение, в которое подпрограмма записывает количество элементов массива, записанных в буфер, на который указывает параметр CounterArray. Если длина буфера, указанная MaximumCount недостаточно велика, чтобы содержать весь массив, подпрограмма записывает необходимую длину в *Count и возвращает STATUS_BUFFER_TOO_SMALL.

Возвращаемое значение

KeQueryHardwareCounterConfiguration возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные значения возвращаемых ошибок включают следующие значения:

Замечания

В Windows 7 эта подпрограмма реализуется только для архитектур на основе x86, x64 и Itanium. Если вызывающий объект выполняется в архитектуре процессора, которая не поддерживается, подпрограмма возвращает STATUS_NOT_IMPLEMENTED.

Чтобы задать конфигурацию счетчика оборудования, используемую для профилирования потоков, вызовите подпрограмму KeSetHardwareCounterConfiguration.

Требования

См. также

HARDWARE_COUNTER

KeSetHardwareCounterConfiguration