IMediaEvent::WaitForCompletion メソッド (control.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
メソッドは WaitForCompletion 、フィルター グラフが使用可能なすべてのデータをレンダリングするのを待機します。 フィルター グラフが実行されているか、メソッドが失敗する必要があります。
構文
HRESULT WaitForCompletion(
[in] long msTimeout,
[out] long *pEvCode
);
パラメーター
[in] msTimeout
タイムアウト間隔 (ミリ秒単位)。 すぐに返すには、0 を渡します。 無限にブロックするには、値 INFINITE を渡します。
[out] pEvCode
イベント コードを受け取る変数へのポインター。 詳細については、「解説」を参照してください。
戻り値
HRESULT 値を返します。 使用可能な値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
成功しました。 |
|
タイムアウトが切れています。 |
|
フィルター グラフが実行されていません。 |
解説
このメソッドは、タイムアウトが切れるか、次のいずれかのイベントが発生するまでブロックします。
待機中、メソッドは他のすべてのイベント通知を破棄します。戻り値がS_OK場合、 pEvCode パラメーターは待機を終了したイベント コードを受け取ります。 メソッドが戻ると、フィルター グラフは引き続き実行されます。 アプリケーションは、必要に応じてグラフを一時停止または停止できます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | control.h (Dshow.h を含む) |
| Library | Strmiids.lib |