IMediaEventEx::SetNotifyFlags

  • Article
 
Microsoft DirectShow 9.0

IMediaEventEx::SetNotifyFlags

The SetNotifyFlags method enables or disables event notifications.

Syntax

  HRESULT SetNotifyFlags(
  long lNoNotifyFlags
);

Parameters

lNoNotifyFlags

[in] Value indicating whether to enable or disable event notifications. Must be one of the following values:

Value Description
Zero Enable event notifications.
AM_MEDIAEVENT_NONOTIFY Disable event notifications.

Return Values

Returns S_OK if successful, or E_INVALIDARG if the lNoNotifyFlags parameter is invalid.

Remarks

By default, the Filter Graph Manager posts event notifications for the application. If the lNoNotifyFlags parameter is AM_MEDIAEVENT_NONOTIFY, the Filter Graph Manager clears any pending event notifications from the queue, and does not post any new ones.

If event notifications are disabled, the handle returned by the IMediaEvent::GetEventHandle method is signaled at the end of each stream—that is, whenever the Filter Graph Manager receives an EC_COMPLETE event.

Requirements

Header: Declared in Control.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also