IMediaEventEx::GetNotifyFlags

  • Article
 
Microsoft DirectShow 9.0

IMediaEventEx::GetNotifyFlags

The GetNotifyFlags method determines whether event notifications are enabled.

Syntax

  HRESULT GetNotifyFlags(
  long *lplNoNotifyFlags
);

Parameters

lplNoNotifyFlags

[out] Pointer to a variable that receives one of the following values:

Value Description
Zero Event notifications are enabled.
AM_MEDIAEVENT_NONOTIFY Event notifications are disabled.

Return Values

Returns S_OK if successful, or E_POINTER if the lplNoNotifyFlags parameter is NULL.

Remarks

By default, the Filter Graph Manager posts event notifications for the application. To disable event notification, call the IMediaEventEx::SetNotifyFlags method with the value AM_MEDIAEVENT_NONOTIFY.

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