AvRtWaitOnThreadOrderingGroup

スレッド順序付けグループのクライアントスレッドが実行すべきタイミングまで待機できるようにする。

AvRtWaitOnThreadOrderingGroup Context

Context : [intptr] コンテキストハンドル。このハンドルは AvRtCreateThreadOrderingGroup または AvRtJoinThreadOrderingGroup 関数から返される。

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

解説

スレッド順序付けグループのクライアントスレッドが実行すべきタイミングまで待機できるようにする。

[戻り値]
関数が成功すると、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]

この関数から戻った後、スレッドは当該周期の処理を完了し、再度この関数を呼び出すべきである。グループ作成時に親スレッドが指定したタイムアウト間隔内にスレッドが処理を完了できなかった場合、そのスレッドはスレッド順序付けグループから削除される。従って、スレッドが処理ループを終えた後、次の
AvRtWaitOnThreadOrderingGroup 呼び出しは失敗し、LastError は
ERROR_ACCESS_DENIED となる。待機中にスレッド順序付けグループが削除された場合、この関数は最終的にタイムアウトし
ERROR_ACCESS_DENIED を返す。

情報

プラグイン / モジュールavrt.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の avrt.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_avrt_gen2.hs