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.