IMediaSeeking2 (Compact 2013)

3/26/2014

This interface adds new functionality to the IMediaSeeking interface. It inherits from and implements all the methods of the IMediaSeeking interface.

When to Implement

The IMediaSeeking interface is implemented in the output pins of source filters. Implement the IMediaSeeking2 interface when you are also supporting skipping items in a playlist.

When to Use

A transform filter will call the IMediaSeeking methods on the connected upstream pin when passing media times upstream from the renderer. This interface is implemented by the output pin of the Windows Media Source Filter to control seeking in Advanced Systems Format (ASF) files and skipping within server-side playlists.

Methods

In addition to the methods inherited from IUnknown this interface exposes the following methods.

IMediaSeeking Method	Description
GetCapabilities	Returns the seeking capabilities of the media stream.
CheckCapabilities	Determines which capabilities exist on a media stream by applying seeking capability flags and checking the returned value.
IsFormatSupported	Determines whether a specified time format is supported.
QueryPreferredFormat	Retrieves the preferred time format to be used by the interface.
GetTimeFormat	Retrieves the current time format.
IsUsingTimeFormat	Determines whether the time format being used in the call is the same as the one currently being used by the interface.
SetTimeFormat	Sets the time format. This determines the format of units used during seeking.
GetDuration	Retrieves the length of time that the media stream will play.
GetStopPosition	Retrieves the position within the media stream at which playback should stop.
GetCurrentPosition	Retrieves the current position within the media stream.
ConvertTimeFormat	Converts a time from one time format to another.
SetPositions	Sets current and stop positions and applies flags to both.
GetPositions	Returns the current and stop position settings.
GetAvailable	Returns the range of times in which seeking is efficient.
SetRate	Sets a new playback rate.
GetRate	Returns the current rate.
GetPreroll	Retrieves the preroll settings.

IMediaSeeking2 Method	Description
IMediaSeeking2::Next	Seeks to the next item in the server-side playlist.
IMediaSeeking2::Previous	Seeks to the previous item in the server-side playlist.

Requirements

Header	dshow.h
Library	Strmiids.lib

See Also

Reference

DirectShow Interfaces
IMediaSeeking