IMediaEvent インターフェイス

IMediaEvent インターフェイスは、イベント通知を取得するメソッドと、フィルタ グラフ マネージャのデフォルトのイベント処理をオーバーライドするメソッドを提供する。IMediaEventEx インターフェイスは、このインターフェイスを継承し、拡張する。

フィルタ グラフ マネージャは、このインターフェイスを実装している。アプリケーションでは、このインターフェイスを使って、ストリームの終了、レンダリング エラーなど、フィルタ グラフ内で発生するイベントに応答できる。フィルタでは、IMediaEventSink インターフェイスを使ってフィルタ グラフにイベントを送る。

イベント通知の詳細については、「DirectShow でのイベント通知」を参照すること。システム定義のイベント通知のリストについては、「イベント通知コード」を参照すること。

IMediaEvent インターフェイスは、IDispatch から継承するメソッド以外に以下のメソッドも公開する。

メソッド	説明
CancelDefaultHandling	指定されたイベントに対するフィルタ グラフ マネージャのデフォルト処理をキャンセルする。
FreeEventParams	イベントの引数に関連付けられたリソースを解放する。
GetEvent	次のイベント通知をイベント キューから取得する。
GetEventHandle	キューにイベント通知が入っている間に通知済み状態の手動リセット イベントのハンドルを取得する。
RestoreDefaultHandling	指定されたイベントに対するフィルタ グラフ マネージャのデフォルト処理を復元する。
WaitForCompletion	フィルタ グラフがすべての有効なデータをレンダリングするまで待機する。