共用方式為

IMediaPosition Interface

  • 發行項
 
Microsoft DirectShow 9.0

IMediaPosition Interface

The 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® 6.0 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.

Method Description
get_Duration Retrieves the duration of the stream.
put_CurrentPosition Sets the current position, relative to the total duration of the stream.
get_CurrentPosition Retrieves the current position, relative to the total duration of the stream.
get_StopTime Retrieves the time at which the playback will stop, relative to the duration of the stream.
put_StopTime Sets the time at which the playback will stop, relative to the duration of the stream.
get_PrerollTime Retrieves the amount of data that will be queued before the start position.
put_PrerollTime Sets the amount of data that will be queued before the start position.
put_Rate Sets the playback rate.
get_Rate Retrieves the playback rate.
CanSeekForward Determines whether the filter graph can seek forward in the stream.
CanSeekBackward Determines whether the filter graph can seek backward in the stream.

Requirements

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

Library: Use Strmiids.lib.