SetThreadGroupAffinity

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

SetThreadGroupAffinity hThread, GroupAffinity, PreviousGroupAffinity

hThread : [intptr] スレッドのハンドル。THREAD_SET_INFORMATION アクセス権が必要。詳細は Thread Security and Access Rights を参照。
GroupAffinity : [var] 指定したスレッドに使用するプロセッサグループアフィニティを指定する GROUP_AFFINITY 構造体。
PreviousGroupAffinity : [var] スレッドの直前のグループアフィニティを受け取る GROUP_AFFINITY 構造体へのポインタ。NULL を指定してもよい。

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

解説

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

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を使う。

[備考]
Windows 11 と Windows Server 2022 以降、64
を超えるプロセッサを持つシステムでは、プロセスとスレッドのアフィニティは既定で全プロセッサグループにまたがる。SetThreadGroupAffinity
関数は、スレッドのアフィニティを GroupAffinity
が指定する単一プロセッサグループ内のプロセッサに制限する。このグループはスレッドのプライマリグループにもなる。本関数を使うアプリケーションをコンパイルするには
_WIN32_WINNT を 0x0601 以上に設定する。詳細は Using the Windows Headers を参照。

情報