共用方式為


GetNumaNodeProcessorMaskEx 函式 (systemtopologyapi.h)

不論節點所屬的處理器群組為何,擷取節點的處理器遮罩。

語法

BOOL GetNumaNodeProcessorMaskEx(
  [in]  USHORT          Node,
  [out] PGROUP_AFFINITY ProcessorMask
);

參數

[in] Node

節點編號。

[out] ProcessorMask

接收指定節點之處理器遮罩 之GROUP_AFFINITY 結構的指標。 處理器遮罩是位向量,其中每個位都代表處理器,以及它是否在節點中。

如果指定的節點未設定處理器, 則 Mask 成員為零,且 未定義群組 成員。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。

備註

GetNumaNodeProcessorMaskEx 函式與 GetNumaNodeProcessorMask 不同,因為它可以擷取節點的處理器遮罩,而不論節點所屬的群組為何。 也就是說,節點不需要位於與呼叫線程相同的群組中。 GetNumaNodeProcessorMask 函式只能針對與呼叫線程位於相同群組中的節點擷取處理器遮罩。

若要擷取系統中最高編號的節點,請使用 GetNumaHighestNodeNumber 函式。 請注意,此數目不保證等於系統中的節點總數。

若要確保您的進程的所有線程都在同一個節點上執行,請使用 SetProcessAffinityMask 函式搭配進程親和性遮罩,以指定相同節點中的處理器。

若要編譯使用此函式的應用程式,請設定 _WIN32_WINNT>= 0x0601。 如需詳細資訊,請參閱 使用 Windows 標頭

注意

TBD Release Iron 開始,此和其他 NUMA 函式的行為已經過修改,以更妥善地支援包含更多 64 個處理器節點的系統。 如需這項變更的詳細資訊,包括啟用此 API 舊行為的相關信息,請參閱 NUMA 支援

從 TBD Release Iron 開始的行為

每個節點都會由系統指派主要群組。 GetNumaNodeProcessorMaskEx 傳回的GROUP_AFFINITY適用於節點的主要群組。

舊版的行為

傳回指定節點 的GROUP_AFFINITY

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 systemtopologyapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

GROUP_AFFINITY

GetNumaNodeProcessorMask

NUMA 支援

處理器群組