GetThreadGroupAffinity 関数 (processtopologyapi.h)
指定したスレッドのプロセッサ グループ アフィニティを取得します。
構文
BOOL GetThreadGroupAffinity(
[in] HANDLE hThread,
[out] PGROUP_AFFINITY GroupAffinity
);
パラメーター
[in] hThread
プロセッサ グループのアフィニティが必要なスレッドへのハンドル。
ハンドルには、THREAD_QUERY_INFORMATIONまたはTHREAD_QUERY_LIMITED_INFORMATIONアクセス権が必要です。 詳細については、「スレッド セキュリティとアクセス権の」を参照してください。
[out] GroupAffinity
スレッドのグループ アフィニティを受け取る GROUP_AFFINITY 構造体へのポインター。
戻り値
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError 使用します。
備考
Windows 11 および Windows Server 2022 以降では、64 個を超えるプロセッサを搭載したシステムでは、プロセスとスレッドのアフィニティは、既定ですべての プロセッサ グループにわたって、システム内のすべてのプロセッサにまたがっています。 GetThreadGroupAffinity 関数は、スレッドのプライマリ グループに対するグループ アフィニティを取得します。
この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT >= 0x0601を設定します。 詳細については、「Windows ヘッダーの使用」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
ターゲット プラットフォーム の | ウィンドウズ |
ヘッダー | processtopologyapi.h (Windows.h を含む) |
ライブラリ | Kernel32.lib |
DLL | Kernel32.dll |
関連項目
GetProcessGroupAffinity の