IMediaPosition Interface

Contains methods for seeking to a position within a stream.

The IMediaSeeking interface improves on this interface. Applications written in C/C++ should use IMediaSeeking instead of IMediaPosition. However, IMediaSeeking is not compatible with Automation, so applications written in Microsoft® Visual Basic® must use IMediaPosition instead.

This interface is exposed by the Filter Graph Manager as well as by individual filters. Applications should obtain an IMediaPosition interface pointer from the Filter Graph Manager, not from a filter. The Filter Graph Manager distributes method calls to all of the renderer filters. The renderer filters propagate the calls upstream to the source filters. This sequence of events ensures that all streams remain synchronized.

If one of the distributed calls returns an error, the Filter Graph Manager returns the first error value it received. Some of the distributed calls may have succeeded in this case. However, the filter graph does not return E_NOTIMPL unless all the distributed calls return E_NOTIMPL. If at least one filter in the graph implements the method, the Filter Graph Manager does not return E_NOTIMPL.

Filter developers: Do not implement this method. Implement IMediaSeeking instead. If your filter supports IMediaSeeking, the Filter Graph Manager automatically handles calls to IMediaPosition.

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