Share via

IMediaEventEx::SetNotifyFlags

  • [アーティクル]

SetNotifyFlags メソッドは、イベント通知を利用可あるいは不可にする。

構文

  HRESULT SetNotifyFlags(
  long lNoNotifyFlags
);

パラメータ

lNoNotifyFlags

[in] イベント通知を利用可にするか不可にするかを示す値。次のいずれかの値でなければならない。

値 説明
ゼロ (0) イベント通知を利用可能にする。
AM_MEDIAEVENT_NONOTIFY イベント通知を利用不可にする。

戻り値

成功した場合は S_OK を返す。lNoNotifyFlags 引数が無効な場合は、E_INVALIDARG を返す。

注意

デフォルトでは、フィルタ グラフ マネージャはアプリケーションにイベント通知を送る。lNoNotifyFlags 引数が AM_MEDIAEVENT_NONOTIFY の場合、フィルタ グラフ マネージャはキューからペンディング状態のイベント通知を消去し、新しいイベント通知は送らない。

イベント通知が利用不可の場合、各ストリームの終わり、すなわち、フィルタ グラフ マネージャが EC_COMPLETE イベントを受け取るたびに、IMediaEvent::GetEventHandle メソッドから返されたハンドルが通知済みになる。

参照