IMediaEvent Interface

Microsoft DirectShow 9.0

IMediaEvent Interface

The IMediaEvent interface contains methods for retrieving event notifications and for overriding the Filter Graph Manager's default handling of events. The IMediaEventEx interface inherits this interface and extends it.

The Filter Graph Manager implements this interface. Applications can use it to respond to events that occur in the filter graph, such as the end of a stream or a rendering error. Filters post events to the filter graph using the IMediaEventSink interface.

For more information about event notification, see Event Notification in DirectShow. For a list of system-defined event notifications, see Event Notification Codes.

In addition to the methods inherited from IDispatch, the IMediaEvent interface exposes the following methods.

Method	Description
CancelDefaultHandling	Cancels the Filter Graph Manager's default handling for a specified event.
FreeEventParams	Frees resources associated with the parameters of an event.
GetEvent	Retrieves the next event notification from the event queue.
GetEventHandle	Retrieves a handle to a manual-reset event that remains signaled while the queue contains event notifications.
RestoreDefaultHandling	Restores the Filter Graph Manager's default handling for a specified event.
WaitForCompletion	Waits for the filter graph to render all available data.

Requirements

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

Library: Use Strmiids.lib.