Функция 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 (include Ntddk.h, Ntifs.h) |
| библиотеки | Hal.lib |
| DLL | Hal.dll |
| IRQL | PASSIVE_LEVEL |