SetProcessDefaultCpuSetMasks 関数 (processthreadsapi.h)

指定したプロセスのスレッドに対する既定の CPU セットの割り当てを設定します。

構文

BOOL SetProcessDefaultCpuSetMasks(
  HANDLE          Process,
  PGROUP_AFFINITY CpuSetMasks,
  USHORT          CpuSetMaskCount
);

パラメーター

Process

既定の CPU セットを設定するプロセスを指定します。 このハンドルには、 PROCESS_SET_LIMITED_INFORMATION アクセス権が必要です。 GetCurrentProcess によって返される値は、ここで指定することもできます。

CpuSetMasks

プロセスの既定の CPU セットとして設定する CPU セットを表す GROUP_AFFINITY 構造体の省略可能なバッファーを指定します。 これが NULL の場合、 SetProcessDefaultCpuSetMasks 関数は割り当てをクリアします。

CpuSetMaskCount

CpuSetMasks 配列のサイズを要素単位で指定します。 バッファーが NULL の場合、この値は 0 である必要があります。

戻り値

有効なパラメーターが渡された場合、この関数は失敗しません。

注釈

SetThreadSelectedCpuSetMasks または SetThreadSelectedCpuSets を使用して CPU セットが明示的に設定されていないこのプロセスに属するスレッドは、SetProcessDefaultCpuSetMasks で指定されたセットを自動的に継承します。

この関数は SetProcessDefaultCpuSets に似ていますが、CPU セット ID ではなくグループ アフィニティを使用して CPU セットの一覧を表す点が除きます。 つまり、結果として得られるプロセスの既定の CPU セット割り当ては、指定されたグループ アフィニティの一覧にホーム プロセッサを含むすべての CPU セットのセットになります。

要件

要件	値
サポートされている最小のクライアント	Windows 11
サポートされている最小のサーバー	Windows Server 2022
Header	processthreadsapi.h
[DLL]	kernel32.dll