IMediaEventEx::SetNotifyFlags
| 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