IMediaPosition interface

The IMediaPosition interface contains methods for seeking to a position within a stream.

Note  Applications should use IMediaSeeking instead of IMediaPosition.
 

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.

When to implement

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

Members

The IMediaPosition interface inherits from the IDispatch interface. IMediaPosition also has these types of members:

Methods

The IMediaPosition interface has these methods.

MethodDescription
CanSeekBackward

Determines whether the filter graph can seek backward in the stream.

CanSeekForward

Determines whether the filter graph can seek forward in the stream.

get_CurrentPosition

Retrieves the current position, relative to the total duration of the stream.

get_Duration

Retrieves the duration of the stream.

get_PrerollTime

Retrieves the amount of data that will be queued before the start position.

get_Rate

Retrieves the playback rate.

get_StopTime

Retrieves the time at which the playback will stop, relative to the duration of the stream.

put_CurrentPosition

Sets the current position, relative to the total duration of the stream.

put_PrerollTime

Sets the amount of data that will be queued before the start position.

put_Rate

Sets the playback rate.

put_StopTime

Sets the time at which the playback will stop, relative to the duration of the stream.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Control.h (include Dshow.h)

Library

Strmiids.lib

See also

IDispatch

 

 

Show: