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 になり、構造体は配列に書き込まれません。

要件

サポートされている最小のクライアント	Windows 10 ビルド 20348
サポートされている最小のサーバー	Windows 10 ビルド 20348
Header	systemtopologyapi.h

関連項目

GetMaximumProcessorGroupCount