IMediaEvent::WaitForCompletion
WaitForCompletion メソッドは、フィルタ グラフがすべての有効なデータをレンダリングするまで待機する。フィルタ グラフが実行中でないと、メソッドは失敗する。
構文
HRESULT WaitForCompletion(
long msTimeout,
long *pEvCode
);
パラメータ
msTimeout
[in] タイムアウト時間 (ミリ秒単位)。即座に戻るには 0 を渡す。無期限に動作を停止するには値 INFINITE を渡す。
pEvCode
[out] イベント コードを受け取る変数へのポインタ。詳細については、「注意」を参照すること。
戻り値
HRESULT 値を返す。可能な値は次のとおりである。
値 | 説明 |
S_OK | 成功。 |
E_ABORT | タイムアウトによる時間切れ。 |
VFW_E_WRONG_STATE | フィルタ グラフが実行中ではない。 |
注意
このメソッドは、タイムアウトが時間切れになるか、次のイベントの 1 つが起こるまで動作を停止する。
待っている間、このメソッドは他のすべてのイベント通知を廃棄する。
戻り値が S_OK の場合、pEvCode 引数は待ち状態終了のイベントコードを受け取る。メソッドが返ったとき、フィルタ グラフはまだ実行している。アプリケーションは必要に応じてグラフをポーズしたり停止したりできる。
参照