SignalObjectAndWait

一つのオブジェクトをシグナル状態にしてから別のオブジェクトを待機する操作を、単一の操作として実行する。

SignalObjectAndWait hObjectToSignal, hObjectToWaitOn, dwMilliseconds, bAlertable

hObjectToSignal : [intptr] シグナル状態にするオブジェクトのハンドル。セマフォ・ミューテックス・イベントを指定できる。
hObjectToWaitOn : [intptr] 待機するオブジェクトのハンドル。SYNCHRONIZE アクセス権が必要。詳細は Synchronization Object Security and Access Rights を参照。指定可能なオブジェクト種別の一覧は備考を参照。
dwMilliseconds : [int] タイムアウト間隔（ミリ秒単位）。指定間隔が経過すると、オブジェクトの状態が非シグナル状態でも完了ルーチンや APC オブジェクトがキューイングされていなくても関数は戻る。0 を指定すると関数はオブジェクトの状態をテストし、キューイングされた完了ルーチンや APC をチェックして即座に戻る。INFINITE を指定するとタイムアウトしない。
bAlertable : [int] TRUE の場合、システムが I/O 完了ルーチンや APC 関数をキューイングするとスレッドはそれを呼び出して関数が戻る。FALSE の場合、関数は戻らず、完了ルーチンや APC 関数も呼ばれない。

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

解説

一つのオブジェクトをシグナル状態にしてから別のオブジェクトを待機する操作を、単一の操作として実行する。

[戻り値]
関数が成功した場合、戻り値は関数を戻らせた原因のイベントを示す。次のいずれかの値となる。
（以下省略）

[備考]
SignalObjectAndWait は SetEvent と WaitForSingleObject
の別呼び出しよりも効率的に、一つのオブジェクトをシグナル状態にしてから別のオブジェクトを待機する手段を提供する。SignalObjectAndWait
は次のオブジェクトを待機できる。
（以下省略）

情報