IMediaSeeking2 (Compact 7)
3/12/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 |
|---|---|
Returns the seeking capabilities of the media stream. |
|
Determines which capabilities exist on a media stream by applying seeking capability flags and checking the returned value. |
|
Determines whether a specified time format is supported. |
|
Retrieves the preferred time format to be used by the interface. |
|
Retrieves the current time format. |
|
Determines whether the time format being used in the call is the same as the one currently being used by the interface. |
|
Sets the time format. This determines the format of units used during seeking. |
|
Retrieves the length of time that the media stream will play. |
|
Retrieves the position within the media stream at which playback should stop. |
|
Retrieves the current position within the media stream. |
|
Converts a time from one time format to another. |
|
Sets current and stop positions and applies flags to both. |
|
Returns the current and stop position settings. |
|
Returns the range of times in which seeking is efficient. |
|
Sets a new playback rate. |
|
Returns the current rate. |
|
Retrieves the preroll settings. |
| IMediaSeeking2 Method | Description |
|---|---|
Seeks to the next item in the server-side playlist. |
|
Seeks to the previous item in the server-side playlist. |
Requirements
Header |
dshow.h |
Library |
Strmiids.lib |