IMediaFilter Interface

Microsoft DirectShow 9.0

IMediaFilter Interface

The IMediaFilter interface controls the streaming state of a filter.

All DirectShow filters implement this interface. It provides methods for switching the filter between states (stopped, paused, and running); for retrieving the filter's current state; and for setting a reference clock. Applications should not call IMediaFilter methods on filters.

The Filter Graph Manager also exposes this interface. Applications can use the SetSyncSource method to set the graph reference clock, and GetSyncSource to retrieve the clock. Applications should not call the other methods on this interface. Instead, use the corresponding methods on the IMediaControl interface.

The IBaseFilter interface inherits from IMediaFilter.

In addition to the methods inherited from IPersist, the IMediaFilter interface exposes the following methods.

Method	Description
Stop	Stops the filter.
Pause	Pauses the filter.
Run	Runs the filter.
GetState	Retrieves the state of the filter (running, stopped, or paused).
SetSyncSource	Sets the reference clock for the filter or the filter graph.
GetSyncSource	Retrieves the current reference clock.

Requirements

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

Library: Use Strmiids.lib.