GetProcessGroupAffinity

指定したプロセスのプロセッサグループアフィニティを取得する。

GetProcessGroupAffinity hProcess, GroupCount, GroupArray

hProcess : [intptr] プロセスのハンドル。このハンドルは PROCESS_QUERY_INFORMATION または PROCESS_QUERY_LIMITED_INFORMATION アクセス権を持つ必要がある。詳細は Process Security and Access Rights を参照。
GroupCount : [var] 入力時には GroupArray 配列の要素数を指定する。出力時には配列に書き込まれたプロセッサグループ数を指定する。配列が小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFER で失敗し、必要な要素数を GroupCount パラメータに設定する。
GroupArray : [var] プロセッサグループ番号の配列。プロセス内のスレッドがグループ内のプロセッサに割り当てられている場合、グループ番号が配列に含まれる。

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

解説

指定したプロセスのプロセッサグループアフィニティを取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError
を使用する。エラー値が ERROR_INSUFFICIENT_BUFFER の場合、GroupCount
パラメータには必要なバッファサイズ（要素数）が含まれる。

[備考]
Windows 11 および Windows Server 2022 以降では、64
を超えるプロセッサを持つシステムにおいて、プロセスとスレッドのアフィニティは既定でシステム内のすべてのプロセッサ群（すべてのプロセッサグループにまたがる）に及ぶ。この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT
>= 0x0601 を設定する。詳細は Using the Windows Headers を参照。

情報