Collapse All Expand All

IltmfPlay::put_CurrentPosition

#include "ltmf.h"

C Syntax	HRESULT IltmfPlay_put_CurrentPosition(pPlay, newVal)
C++ Syntax	HRESULT put_CurrentPosition(newVal)

 

IltmfPlay *pPlay;	/* pointer to an interface */
double newVal;	/* new position */

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

Parameter	Description
pPlay	Pointer to an IltmfPlay interface.
newVal	New position, in seconds.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the MediaFoundation documentation.

Comments

The position specified by the Position 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 object seek to the middle of the file, regardless of playback rate.

Users should call IltmfPlay::CheckSeekingCapabilities to determine if ltmfPlay_Seeking_Backward and ltmfPlay_Seeking_Forward are enabled.

Required DLLs and Libraries

LTMF For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:	IltmfPlay::CheckSeekingCapabilities, IltmfPlay::get_CurrentPosition, IltmfPlay::put_CurrentFramePosition, IltmfPlay::put_CurrentTrackingPosition
Topics:	Media Foundation Function Group

Example

For a C++ example, refer to the Simple Media Player for C++.