KeSetHardwareCounterConfiguration 函式 （ntddk.h）
KeSetHardwareCounterConfiguration 例程會指定要用於線程分析的硬體計數器清單。
語法
NTSTATUS KeSetHardwareCounterConfiguration(
[in] PHARDWARE_COUNTER CounterArray,
[in] ULONG Count
);
參數
[in] CounterArray
HARDWARE_COUNTER 陣列的指標，描述用於線程分析的硬體計數器組態。 每個數位元素都是描述硬體計數器的結構。 在例程傳回之前，它會將此數位的內容複製到其內部數據結構中。
[in] Count
指定 CounterArray 參數所指向之陣列中的元素數目。
傳回值
KeSetHardwareCounterConfiguration 如果呼叫成功，就會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列專案：
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_PARAMETER | Count 參數的值超過 MAX_HW_COUNTERS 常數所指定的計數器數目上限，該常數定義於 Ntddk.h 頭檔中。 |
| STATUS_WMI_ALREADY_ENABLED | CounterArray 陣列中指定的一或多個計數器已經啟用。 |
| STATUS_NOT_IMPLEMENTED | 此例程不會針對呼叫端執行的處理器架構實作。 |
言論
在 Windows 7 中，此例程只會針對 x86 型、x64 型和 Itanium 架構實作。 如果呼叫端在不支援的處理器架構上執行，例程會傳回STATUS_NOT_IMPLEMENTED。
此例程會告訴作系統要用於線程分析的硬體計數器。 只有在停用線程分析時，才呼叫此例程。 如果 CounterArray 陣列指定目前使用的任何硬體計數器，則例程會失敗並傳回STATUS_WMI_ALREADY_ENABLED。
應用程式線程可讓線程分析從本機處理器效能監視單位 （PMU） 中的硬體計數器取得一組效能測量。 作系統一次只支援一個分析應用程式。 不支援線程分析應用程式的並行實例。 線程可以啟用本身的線程分析，但不能啟用其他線程的線程分析。
啟用線程分析時，作系統會使用最後一次呼叫中指定的硬體計數器，KeSetHardwareCounterConfiguration。 每個成功的 KeSetHardwareCounterConfiguration 呼叫都會取代先前 KeSetHardwareCounterConfiguration 呼叫中可能設定的任何硬體計數器組態。
設定 Count = 0 以指定空的硬體計數器組態。 此設定可有效地防止使用硬體計數器進行線程分析。 在系統啟動之後和初始 KeSetHardwareCounterConfiguration 之前存在的預設硬體計數器組態， 呼叫是空的組態。
成功 KeSetHardwareCounterConfiguration 呼叫的效果為全域。 如果分析任何進程中的線程，分析工具會使用最後一次呼叫 KeSetHardwareCounterConfiguration所設定的硬體計數器組態。 在多處理器系統中，KeSetHardwareCounterConfiguration 呼叫會設定硬體計數器組態，以用於系統中所有處理器的線程分析，不過每個處理器都會使用自己的一組硬體計數器。
為了避免資源衝突，所有使用計數器資源的驅動程式都應該使用 HalAllocateHardwareCounters 和 HalFreeHardwareCounters 例程來協調這些資源的共用。
若要判斷指定的線程是否已啟用線程分析，請呼叫 QueryThreadProfiling 函式。
若要查詢目前作用於線程分析的硬體計數器組態作系統，請呼叫 KeQueryHardwareCounterConfiguration 例程。
虛擬化軟體通常不會虛擬化硬體性能計數器。 因此，硬體性能計數器不太可能在虛擬機中使用。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 7 開始提供。 |
| 目標平臺 | 普遍 |
| 標頭 | ntddk.h （包括 Ntddk.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |