Поделиться через


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

Подпрограмма HalFreeHardwareCounters освобождает набор ресурсов счетчиков производительности оборудования, которые были получены в предыдущем вызове процедуры HalAllocateHardwareCounters .

Синтаксис

NTSTATUS HalFreeHardwareCounters(
  _In_ HANDLE CounterSetHandle
);

Параметры

[in] CounterSetHandle

Дескриптор выделенных ресурсов счетчика. Вызывающий объект получил этот дескриптор в предыдущем вызове HalAllocateHardwareCounters.

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

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

Код возврата Описание
STATUS_INVALID_PARAMETER Параметр CounterSetHandle не является допустимым дескриптором ресурсов счетчика.

Комментарии

Перед вызовом этой функции драйвер клиента должен остановить и очистить связанные ресурсы счетчика.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 7 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть ntddk.h (включая Ntddk.h, Ntifs.h)
Библиотека Hal.lib
DLL Hal.dll
IRQL PASSIVE_LEVEL

См. также раздел

HalAllocateHardwareCounters