SwitchToThread

呼び出し側スレッドが現在のプロセッサ上で実行可能な別スレッドに実行を譲る。OS が次に実行するスレッドを選択する。

SwitchToThread

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

解説

呼び出し側スレッドが現在のプロセッサ上で実行可能な別スレッドに実行を譲る。OS が次に実行するスレッドを選択する。

[戻り値]
SwitchToThread の呼び出しで OS が別スレッドに実行を切り替えた場合、戻り値は 0
以外。実行可能な他スレッドがなく切り替えなかった場合は 0 となる。

[備考]
実行の譲渡は、呼び出し側スレッドのプロセッサ上で最大 1 スレッドスケジューリングタイムスライスの間有効である。OS
は他のプロセッサにスレッドを切り替えない。アイドルや低優先度スレッドが動作中でも切り替えない。譲渡したスレッドのタイムスライス経過後、OS
は譲渡したスレッドの実行を再スケジュールする。再スケジュールは譲渡したスレッドの優先度と他の実行可能スレッドの状態によって決まる。OS
は同時実行制御のみで実行が妨げられているスレッドへは切り替えない。たとえば I/O
完了ポートやスレッドプールは関連スレッドの最大数を制限する。最大数が既に動作中なら追加スレッドは動作できない。SwitchToThread
を使ってこれら追加スレッドの作業完了を待つとプロセスがデッドロックする可能性がある。本関数を使うアプリケーションをコンパイルするには
_WIN32_WINNT を 0x0400 以上に定義する。

情報

プラグイン / モジュール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