KeQueryGroupAffinity 函式 (wdm.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 和更新版本的 Windows 操作系統中使用任何群組導向功能的驅動程式應該呼叫 KeQueryGroupAffinity， 而不是 KeQueryActiveProcessors。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | 任何層級 |