Функция 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 |