次の方法で共有


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

プロセッサ グループの