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。

規格需求

另請參閱

KAFFINITY

KeQueryActiveProcessors