KeQueryGroupAffinity 函式 (ntddk.h)
KeQueryGroupAffinity 例程會傳回親和性遮罩,識別多處理器系統中指定群組中的使用中邏輯處理器。
語法
KAFFINITY KeQueryGroupAffinity(
[in] USHORT GroupNumber
);
參數
[in] GroupNumber
組號。 如果多處理器系統包含 n 個 群組,則群組編號為 0 到 n-1。 若要取得系統中的作用中群組數目,請呼叫 KeQueryActiveGroupCount 例程。
傳回值
KeQueryGroupAffinity 會傳回 KAFFINITY 值,識別指定群組中的使用中邏輯處理器。 如果 GroupNumber 參數值不是有效的組數,則例程會傳回零。
言論
KeQueryActiveProcessors相關的例程會傳回代表一組作用中處理器的親和性遮罩,但此例程與 KeQueryGroupAffinity不同,不接受組號做為輸入參數。 在 Windows 7 和更新版本的 Windows作系統中,KeQueryActiveProcessors 會傳回群組 0 中作用中處理器的親和性遮罩,這與舊版 Windows 中不支援群組的這個例程行為相容。 此行為可確保呼叫 KeQueryActiveProcessors 的現有驅動程式,且不會在具有兩個或多個群組的多處理器系統中正確執行任何群組導向功能。 不過,在 Windows 7 和更新版本中使用任何群組導向功能的驅動程式應該呼叫 KeQueryGroupAffinity,而不是 KeQueryActiveProcessors。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
目標平臺 | 普遍 |
標頭 | ntddk.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | 任何層級 |