Export (0) Print
Expand All

IMediaPosition::put_CurrentPosition method

The put_CurrentPosition method sets the current position, relative to the total duration of the stream.

Syntax


HRESULT put_CurrentPosition(
  [in]  REFTIME llTime
);

Parameters

llTime [in]

New position, in seconds.

Return value

Returns an HRESULT value. Possible values include the following:

Return codeDescription
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

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

Error and Success Codes
IMediaPosition Interface

 

 

Community Additions

ADD
Show:
© 2014 Microsoft