HalFreeHardwareCounters 函式 (ntddk.h)
HalFreeHardwareCounters 例程會釋放一組在先前 呼叫 HalAllocateHardwareCounters 例程時取得的硬體性能計數器資源。
語法
NTSTATUS HalFreeHardwareCounters(
_In_ HANDLE CounterSetHandle
);
參數
[in] CounterSetHandle
已配置計數器資源的句柄。 呼叫者在先前呼叫 HalAllocateHardwareCounters 中取得此句柄。
傳回值
如果呼叫成功,HalFreeHardwareCounters 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列專案:
傳回碼 | 描述 |
---|---|
STATUS_INVALID_PARAMETER | Parameter CounterSetHandle 不是有效的計數器資源句柄。 |
言論
呼叫此函式之前,用戶端驅動程序應該會停止並清除相關聯的計數器資源。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
目標平臺 | 普遍 |
標頭 | ntddk.h (include Ntddk.h, Ntifs.h) |
連結庫 | Hal.lib |
DLL | Hal.dll |
IRQL | PASSIVE_LEVEL |