IMediaEvent インターフェイス (control.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
インターフェイスには IMediaEvent 、イベント通知を取得するためのメソッドと、Filter Graph Manager のイベントの既定の処理をオーバーライドするためのメソッドが含まれています。 IMediaEventEx インターフェイスはこのインターフェイスを継承して拡張します。
Filter Graph Manager は、このインターフェイスを実装します。 アプリケーションはそれを使用して、ストリームの終了やレンダリング エラーなど、フィルター グラフで発生するイベントに応答できます。 IMediaEventSink インターフェイスを使用して、ポスト イベントをフィルター グラフにフィルター処理します。
イベント通知の詳細については、「 DirectShow でのイベント通知」を参照してください。 システム定義のイベント通知の一覧については、「 イベント通知コード」を参照してください。
継承
IMediaEvent インターフェイスは、IDispatch インターフェイスから継承されます。 IMediaEvent には、次の種類のメンバーもあります。
メソッド
IMediaEvent インターフェイスには、これらのメソッドがあります。
| IMediaEvent::CancelDefaultHandling CancelDefaultHandling メソッドは、指定したイベントに対する Filter Graph Manager の既定の処理を取り消します。 イベント通知がアプリケーションに渡されます。 |
| IMediaEvent::FreeEventParams FreeEventParams メソッドは、イベントのパラメーターに関連付けられているリソースを解放します。 |
| IMediaEvent::GetEvent GetEvent メソッドは、イベント キューから次のイベント通知を取得します。 |
| IMediaEvent::GetEventHandle GetEventHandle メソッドは、キューにイベント通知が含まれている間、シグナル状態のままの手動リセット イベントへのハンドルを取得します。 |
| IMediaEvent::RestoreDefaultHandling RestoreDefaultHandling メソッドは、指定したイベントに対するフィルター グラフ マネージャーの既定の処理を復元します。 |
| IMediaEvent::WaitForCompletion WaitForCompletion メソッドは、フィルター グラフが使用可能なすべてのデータをレンダリングするのを待機します。 フィルター グラフが実行されているか、メソッドが失敗する必要があります。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | control.h (Dshow.h を含む) |