GetNumaNodeProcessorMask2 関数 (systemtopologyapi.h)

指定したノードの複数グループ プロセッサ マスクを取得します。

構文

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

パラメーター

NodeNumber

対象ノードの 0 から始まるノード番号を指定します。

ProcessorMasks

GROUP_AFFINITY構造体の配列。正常に戻ると、指定したノードのプロセッサ マスクが記述されます。

配列内の各要素は、1 つのプロセッサ グループ内のノードに属するプロセッサのセットを記述します。 このノードにアクティブなプロセッサがあるプロセッサ グループごとに、結果の配列に 1 つの要素があります。

ProcessorMaskCount

ProcessorMasks 配列のサイズを要素単位で指定します。

RequiredMaskCount

正常に戻った場合は、配列に書き込まれるアフィニティ構造の数を指定します。

入力配列が小さすぎる場合、 関数はERROR_INSUFFICIENT_BUFFER で失敗し、 RequiredMaskCount パラメーターに必要な要素の数を設定します。

必要な要素の数は、 常に GetMaximumProcessorGroupCount によって返される最大グループ数以下です。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 になり、 GetLastError を呼び出すことによって拡張エラー情報を取得できます。

指定された配列が小さすぎる場合、エラー値は ERROR_INSUFFICIENT_BUFFER され、RequiredMaskCount パラメーターは必要な要素の数に設定されます。

指定された NodeNumber が無効な場合 (つまり、GetNumaHighestNodeNumber によって返される値より大きい)、エラー値は ERROR_INVALID_PARAMETER。

注釈

指定されたノードにプロセッサが関連付けられていない場合 (つまり、メモリまたは周辺機器のみが含まれます)、返される RequiredMaskCount は 0 になり、構造体は配列に書き込まれません。

Requirements

こちらも参照ください

GetMaximumProcessorGroupCount