Microsoft DirectX 8.1 (C++)

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 Value

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.

See Also