IMediaEventEx

IMediaEventEx インターフェイスは IMediaEvent インターフェイスを継承しており、イベント通知を取得するためのメソッドと、フィルターグラフによる既定のイベント処理をオーバーライドするためのメソッドを含みます。

SetNotifyWindow メソッドは、イベント通知を処理するウィンドウを登録します。

成功した場合は S_OK を返します。hwnd パラメーターが有効なウィンドウハンドルでない場合は E_INVALIDARG を返します。

このメソッドは、イベント通知を処理するウィンドウを指定します。Filter Graph Manager はイベントキューにイベントを格納するたびに、指定されたウィンドウにもメッセージをポストします。hwnd パラメーターはウィンドウを指定し、lMsg パラメーターはメッセージを指定します。アプリケーションは、この目的のためにプライベートなウィンドウメッセージを定義する必要があります。メッセージの lParam パラメーターには lInstanceData の値が設定され、wParam パラメーターには 0 が設定されます。

ウィンドウがメッセージを受け取ったら、IMediaEvent::GetEvent メソッドを呼び出してイベントを取得する必要があります。イベントは非同期であるため、キューには複数のイベントが含まれる場合も、まったく含まれない場合もあります。GetEvent をエラーコードが返されるまで繰り返し呼び出してください。

SetNotifyFlags メソッドは、イベント通知を有効または無効にします。

成功した場合は S_OK を返します。lNoNotifyFlags パラメーターが無効な場合は E_INVALIDARG を返します。

既定では、Filter Graph Manager はアプリケーションのためにイベント通知をポストします。lNoNotifyFlags パラメーターが AM_MEDIAEVENT_NONOTIFY の場合、Filter Graph Manager はキューから保留中のイベント通知をすべてクリアし、新しい通知をポストしません。

イベント通知が無効になっている場合でも、IMediaEvent::GetEventHandle メソッドが返すハンドルは、各ストリームの終端で、つまり Filter Graph Manager が EC_COMPLETE イベントを受け取るたびにシグナル状態になります。

GetNotifyFlags メソッドは、イベント通知が有効かどうかを判定します。

成功した場合は S_OK を返します。lplNoNotifyFlags パラメーターが NULL の場合は E_POINTER を返します。

既定では、Filter Graph Manager はアプリケーションのためにイベント通知をポストします。イベント通知を無効にするには、IMediaEventEx::SetNotifyFlags メソッドを AM_MEDIAEVENT_NONOTIFY の値で呼び出します。

イベント通知が無効になっている場合でも、IMediaEvent::GetEventHandle メソッドが返すハンドルは、各ストリームの終端で、つまり Filter Graph Manager が EC_COMPLETE イベントを受け取るたびにシグナル状態になります。