指定したスレッドのプロセッサグループアフィニティを取得する。
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 |
| URL | https://github.com/inovia/IronHSP |
| 備考 | Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。 |
| タイプ | 拡張命令 |
| グループ | Win32API |
| 対応環境 |
|
| hs ファイル | hsphelp\win32_kernel32_gen2.hs |