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) |
| Library | Hal.lib |
| DLL | Hal.dll |
| IRQL | PASSIVE_LEVEL |