SetThreadIdealProcessor

スレッドの優先プロセッサを設定する。システムは可能な限り優先プロセッサ上でスレッドをスケジュールする。

SetThreadIdealProcessor hThread, dwIdealProcessor

hThread : [intptr] 優先プロセッサを設定するスレッドのハンドル。THREAD_SET_INFORMATION アクセス権が必要。詳細は Thread Security and Access Rights を参照。
dwIdealProcessor : [int] スレッドの優先プロセッサ番号。0 から始まる。MAXIMUM_PROCESSORS を指定すると、本関数は現在の理想プロセッサを変更せずに返す。

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

解説

スレッドの優先プロセッサを設定する。システムは可能な限り優先プロセッサ上でスレッドをスケジュールする。

[戻り値]
関数が成功した場合、戻り値は直前の優先プロセッサである。関数が失敗した場合、戻り値は (DWORD) -1
となる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
コンピュータのプロセッサ数を調べるには GetSystemInfo を使う。スレッドが実行可能なプロセッサを調べるには
GetProcessAffinityMask も使える。GetProcessAffinityMask
はビットマスクを返すが、SetThreadIdealProcessor はプロセッサを整数で表現する点に注意。Windows 11 と
Windows Server 2022 以降、64
を超えるプロセッサを持つシステムでは、プロセスとスレッドのアフィニティは既定で全プロセッサグループにまたがる。SetThreadIdealProcessor
は、優先プロセッサとしてスレッドのプライマリグループ内の論理プロセッサを設定する。本関数を使うアプリケーションをコンパイルするには
_WIN32_WINNT を 0x0400 以上に定義する。Windows 8.1 と Windows Server 2012 R2:
本関数は Windows 8.1、Windows Server 2012 R2 以降の Windows ストアアプリでサポートされる。

情報