Event Notification Codes

This sections lists the DirectShow events that are not specific to DVD. For events specific to DVD, see DVD Event Notification Codes.

Filters send events to the Filter Graph Manager by calling the IMediaEventSink::Notify method. The Filter Graph Manager handles some events and queues others for the application. The application retrieves them by calling the IMediaEvent::GetEvent method.

In the sections that follow, each entry lists the event code, the meaning of the event parameters, and the Filter Graph Manager's default action for the event, if any. To override the default action, call IMediaEvent::CancelDefaultHandling. Event codes are defined in the header files Evcode.h and Audevcod.h. If there is no default action, the Filter Graph Manager automatically forwards the event to the application (through the event queue).

Custom Events

Filters can define custom events with event codes in the range EC_USER and higher. The Filter Graph Manager will place these directly in the event queue. However, the following caveats apply:

The Filter Graph Manager cannot free the event parameters using the normal IMediaEvent::FreeEventParams method. The application must free any memory or reference counts associated with the event parameters.
The filter should only send the event from within an application that is prepared to handle the event. (Possibly the application can set a custom property on the filter to indicate that it is safe to send the event.)

Event notification code	Description
EC_ACTIVATE	A video window is being activated or deactivated.
EC_BANDWIDTHCHANGE	Not supported.
EC_BUFFERING_DATA	The graph is buffering data, or has stopped buffering data.
EC_BUILT	Send by the Video Control when a graph has been built. Not forwarded to applications.
EC_CLOCK_CHANGED	The reference clock has changed.
EC_CLOCK_UNSET	The clock provider was disconnected.
EC_CODECAPI_EVENT	Sent by an encoder to signal an encoding event.
EC_COMPLETE	All data from a particular stream has been rendered.
EC_CONTENTPROPERTY_CHANGED	Not supported.
EC_DEVICE_LOST	A Plug and Play device was removed or has become available again.
EC_DISPLAY_CHANGED	The display mode has changed.
EC_END_OF_SEGMENT	The end of a segment has been reached.
EC_EOS_SOON	Not supported.
EC_ERROR_STILLPLAYING	An asynchronous command to run the graph has failed.
EC_ERRORABORT	An operation was aborted because of an error.
EC_ERRORABORTEX	An operation was aborted because of an error.
EC_EXTDEVICE_MODE_CHANGE	Not supported.
EC_FILE_CLOSED	The source file was closed because of an unexpected event.
EC_FULLSCREEN_LOST	The video renderer is switching out of full-screen mode.
EC_GRAPH_CHANGED	The filter graph has changed.
EC_LENGTH_CHANGED	The length of a source has changed.
EC_LOADSTATUS	Notifies the application of progress when opening a network file.
EC_MARKER_HIT	Not supported.
EC_NEED_RESTART	A filter is requesting that the graph be restarted.
EC_NEW_PIN	Not supported.
EC_NOTIFY_WINDOW	Notifies a filter of the video renderer's window.
EC_OLE_EVENT	A filter is passing a text string to the application.
EC_OPENING_FILE	The graph is opening a file, or has finished opening a file.
EC_PALETTE_CHANGED	The video palette has changed.
EC_PAUSED	A pause request has completed.
EC_PLEASE_REOPEN	The source file has changed.
EC_PREPROCESS_COMPLETE	Sent by the WM ASF Writer filter when it completes the pre-processing for multipass encoding.
EC_PROCESSING_LATENCY	Indicates the amount of time that a component is taking to process each sample.
EC_QUALITY_CHANGE	The graph is dropping samples, for quality control.
EC_RENDER_FINISHED	Not supported.
EC_REPAINT	A video renderer requires a repaint.
EC_SAMPLE_LATENCY	Specifies how far behind schedule a component is for processing samples.
EC_SAMPLE_NEEDED	Requests a new input sample from the Enhanced Video Renderer (EVR) filter.
EC_SCRUB_TIME	Specifies the time stamp for the most recent frame step.
EC_SEGMENT_STARTED	A new segment has started.
EC_SHUTTING_DOWN	The filter graph is shutting down, prior to being destroyed.
EC_SNDDEV_IN_ERROR	A device error has occurred in an audio capture filter.
EC_SNDDEV_OUT_ERROR	A device error has occurred in an audio renderer filter.
EC_STARVATION	A filter is not receiving enough data.
EC_STATE_CHANGE	The filter graph has changed state.
EC_STATUS	Contains two arbitrary status strings.
EC_STEP_COMPLETE	A filter performing frame stepping has stepped the specified number of frames.
EC_STREAM_CONTROL_STARTED	A stream-control start command has taken effect.
EC_STREAM_CONTROL_STOPPED	A stream-control stop command has taken effect.
EC_STREAM_ERROR_STILLPLAYING	An error has occurred in a stream. The stream is still playing.
EC_STREAM_ERROR_STOPPED	A stream has stopped because of an error.
EC_TIMECODE_AVAILABLE	Not supported.
EC_UNBUILT	Send by the Video Control when a graph has been torn down. Not forwarded to applications.
EC_USERABORT	The user has terminated playback.
EC_VIDEO_SIZE_CHANGED	The native video size has changed.
EC_VIDEOFRAMEREADY	A video frame is ready for display.
EC_VMR_RECONNECTION_FAILED	Sent by the VMR-7 and the VMR-9 when it was unable to accept a dynamic format change request from the upstream decoder.
EC_VMR_RENDERDEVICE_SET	Sent when the VMR has selected its rendering mechanism.
EC_VMR_SURFACE_FLIPPED	Sent when the VMR-7's allocator presenter has called the DirectDraw Flip method on the surface being presented.
EC_WINDOW_DESTROYED	The video renderer was destroyed or removed from the graph.
EC_WMT_EVENT	Sent by the WM ASF Reader filter when it reads ASF files protected by digital rights management (DRM).
EC_WMT_INDEX_EVENT	Sent when an application uses the WM ASF Writer to index Windows Media Video files.

See Also