Microsoft DirectX 8.1 (C++)

IMediaFilter Interface

Controls the streaming state of a filter.

All Microsoft® 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.

IMediaFilter inherits the IPersist interface. The IBaseFilter interface inherits from IMediaFilter.

In addition to the methods inherited from IUnknown and 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.