SetProcessAffinityMask

指定したプロセスのスレッドに対するプロセッサアフィニティマスクを設定する。

SetProcessAffinityMask hProcess, dwProcessAffinityMask

hProcess : [intptr] アフィニティマスクを設定するプロセスへのハンドル。このハンドルには PROCESS_SET_INFORMATION アクセス権が必要である。詳細は「プロセスのセキュリティとアクセス権」を参照。
dwProcessAffinityMask : [int] プロセスのスレッド用のアフィニティマスク。64 個を超えるプロセッサを持つシステムでは、アフィニティマスクは単一プロセッサグループ内のプロセッサを指定しなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

指定したプロセスのスレッドに対するプロセッサアフィニティマスクを設定する。

[戻り値]
関数が成功した場合、戻り値は非ゼロである。失敗した場合はゼロである。拡張エラー情報を取得するには GetLastError
を呼び出す。システムに構成されていないプロセッサを要求した場合、最終エラーコードは ERROR_INVALID_PARAMETER
となる。64 個を超えるプロセッサを持つシステムで、呼び出し側プロセスが複数のプロセッサグループにスレッドを持つ場合も最終エラーコードは
ERROR_INVALID_PARAMETER となる。

[備考]

プロセスアフィニティマスクは、プロセスのスレッドが実行を許可される論理プロセッサを各ビットで表すビットベクタである。プロセスアフィニティマスクの値は
GetProcessAffinityMask
関数で取得されるシステムアフィニティマスク値の部分集合でなければならない。プロセスはシステムに構成されたプロセッサ上でのみ実行可能なので、システムアフィニティマスクで
0 のビットを 1
に指定することはできない。プロセスアフィニティは子プロセスまたは新しくインスタンス化されたローカルプロセスに継承される。自分以外のプロセスから呼ばれる可能性のある
DLL 内で SetProcessAffinityMask を呼ぶべきではない。64
個を超えるプロセッサを持つシステムでは、SetProcessAffinityMask
は単一プロセッサグループ内のスレッドを持つプロセスに対してのみ使用できる。複数グループ内の個別スレッドのアフィニティマスクを設定するには
SetThreadAffinityMask を使用する。これは事実上プロセスのグループ割当を変更する。Windows 11 /
Windows Server 2022 以降、64
個を超えるプロセッサを持つシステムでは、プロセスとスレッドのアフィニティは既定で全プロセッサグループのすべてのプロセッサにまたがる。呼び出し側プロセスが複数のプロセッサグループにスレッドを持つ場合でも常に失敗するのではなく、プロセスが
1 つ以上のスレッドのアフィニティをプロセスの主グループ外に明示的に設定している場合に SetProcessAffinityMask
は失敗 (ゼロを返し最終エラーコード ERROR_INVALID_PARAMETER) する。

情報