HalFreeHardwareCounters 函式 (ntddk.h)
HalFreeHardwareCounters 例程會釋放先前呼叫 HalAllocateHardwareCounters 例程中取得的一組硬體性能計數器資源。
語法
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
參數
[in] CounterSetHandle
已配置計數器資源的句柄。 呼叫端在先前對 HalAllocateHardwareCounters 的呼叫中取得此句柄。
傳回值
如果呼叫成功，HalFreeHardwareCounters 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列各項：
| 傳回碼 | Description |
|---|---|
| STATUS_INVALID_PARAMETER | 參數 CounterSetHandle 不是有效的計數器資源句柄。 |
備註
呼叫此函式之前，用戶端驅動程序應該會停止並清除相關聯的計數器資源。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows 7 和更新版本的 Windows 中使用。 |
| 目標平台 | Universal |
| 標頭 | ntddk.h (包含 Ntddk.h、Ntifs.h) |
| 程式庫 | Hal.lib |
| Dll | Hal.dll |
| IRQL | PASSIVE_LEVEL |