指定された UMS ワーカースレッドを実行する。
ExecuteUmsThread UmsThread
UmsThread : [intptr] 実行するワーカースレッドの UMS スレッドコンテキストへのポインタ。
(プラグイン / モジュール : kernel32.dll)
指定された UMS ワーカースレッドを実行する。 [戻り値] 関数が成功した場合、値を返さない。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError を呼ぶ。発生し得るエラーコードには次のものが含まれる。 (以下省略) [備考] ExecuteUmsThread 関数は、指定された UMS ワーカースレッドの状態を呼び出し側 UMS スケジューラスレッドの状態の上にロードし、ワーカースレッドが実行できるようにする。ワーカースレッドは UmsThreadYield 関数を呼んで譲歩するか、ブロックするか、終了するまで実行される。ワーカースレッドが譲歩またはブロックすると、システムはスケジューラスレッドの UmsSchedulerProc エントリポイント関数を呼ぶ。以前にブロックされていたワーカースレッドのブロックが解除されると、システムはワーカースレッドが作成されたときに UpdateProcThreadAttribute 関数で指定された完了リストにワーカースレッドをキューする。ExecuteUmsThread 関数は、エラーが発生しない限り戻らない。関数が ERROR_RETRY を返した場合、エラーは一時的なもので操作を再試行できる。関数が ERROR_RETRY 以外のエラーを返した場合、アプリケーションのスケジューラはそれぞれ UmsThreadIsSuspended または UmsThreadIsTerminated で QueryUmsThreadInformation を呼び、スレッドがサスペンドまたは終了しているかを確認すべきである。その他の発生し得るエラーには、UMS スケジューラスレッドではないスレッド上で関数を呼び出した場合、無効な UMS ワーカースレッドコンテキストを渡した場合、または既に別のスケジューラスレッド上で実行中のワーカースレッドを指定した場合などが含まれる。
| プラグイン / モジュール | 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 |