GetThreadGroupAffinity

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

GetThreadGroupAffinity hThread, GroupAffinity

hThread : [intptr] プロセッサグループアフィニティを取得するスレッドのハンドル。ハンドルは THREAD_QUERY_INFORMATION または THREAD_QUERY_LIMITED_INFORMATION アクセス権を持つ必要がある。詳細は Thread Security and Access Rights を参照。
GroupAffinity : [var] スレッドのグループアフィニティを受け取る GROUP_AFFINITY 構造体へのポインタ。

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

解説

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

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

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

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs