IMediaPosition::put_CurrentPosition
| Microsoft DirectShow 9.0 |
IMediaPosition::put_CurrentPosition
The put_CurrentPosition method sets the current position, relative to the total duration of the stream.
Syntax
HRESULT put_CurrentPosition( REFTIME llTime );
Parameters
llTime
[in] New position, in seconds.
Return Values
Returns an HRESULT value. Possible values include the following:
| Return code | Description |
| S_FALSE | Graph was paused and is in transition back to a running state. |
| S_OK | Success. |
| E_INVALIDARG | Invalid argument. |
| E_NOTIMPL | Not implemented. |
Remarks
The position specified by the llTime parameter is relative to the total duration, ignoring playback rate. For example, if a source file is 10 seconds long, setting the position to 5.0 causes the graph to seek to the middle of the file, regardless of playback rate.
If the filter graph is running, the Filter Graph Manager pauses the graph, issues the seek command, and then runs the graph again. If the method returns while the graph is still transitioning to a running state, the return value is S_FALSE.
If a filter is paused when it receives a seek command, it must flush existing data before it introduces the data from the new position. See IPin::BeginFlush and IPin::EndFlush.
Requirements
Header: Declared in Control.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also