GetNumaNodeProcessorMask2 函式 (systemtopologyapi.h)

擷取指定節點的多群組處理器遮罩。

語法

BOOL GetNumaNodeProcessorMask2(
  USHORT          NodeNumber,
  PGROUP_AFFINITY ProcessorMasks,
  USHORT          ProcessorMaskCount,
  PUSHORT         RequiredMaskCount
);

參數

NodeNumber

為感興趣的節點提供以零起始的節點編號。

ProcessorMasks

GROUP_AFFINITY結構的陣列，此陣列會在成功傳回時描述指定節點的處理器遮罩。

陣列中的每個元素都會描述屬於單一處理器群組內節點的一組處理器。 此節點在其中具有作用中處理器的每個處理器群組，產生的陣列中會有一個元素。

ProcessorMaskCount

指定 元素中的 ProcessorMasks 陣列大小。

RequiredMaskCount

在成功傳回時，指定寫入陣列的同質結構數目。

如果輸入陣列太小，函式會因為 ERROR_INSUFFICIENT_BUFFER 而失敗，並將 RequiredMaskCount 參數設定為所需的元素數目。

必要元素的數目一律小於或等於 GetMaximumProcessorGroupCount所傳回的最大群組計數。

傳回值

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

如果函式失敗，傳回值為零，而且呼叫 GetLastError即可擷取擴充錯誤資訊。

如果提供的陣列太小，則錯誤值 會ERROR_INSUFFICIENT_BUFFER ，而且 RequiredMaskCount 參數會設定為所需的元素數目。

如果提供的 NodeNumber 無效 (亦即大於 GetNumaHighestNodeNumber 所傳回的值) ，則會 ERROR_INVALID_PARAMETER錯誤值。

備註

如果指定的節點沒有任何與其相關聯的處理器 (亦即它只包含記憶體或周邊) ，則傳回 的 RequiredMaskCount 會是 0，而且不會將任何結構寫入陣列。

規格需求

最低支援的用戶端	Windows 10組建 20348
最低支援的伺服器	Windows 10組建 20348
標頭	systemtopologyapi.h

另請參閱

GetMaximumProcessorGroupCount