IltmmPlay::put_CurrentPosition

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay__put_CurrentPosition(pPlay, newVal)

C++ Syntax

HRESULT put_CurrentPosition(newVal)

 

IltmmPlay *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 IltmmPlay 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 DirectShow 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 IltmmPlay::CheckSeekingCapabilities to determine if ltmmPlay_Seeking_Backward and ltmmPlay_Seeking_Forward are enabled.

Required DLLs and Libraries

LTMM

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

See Also

Elements:

IltmmPlay::CheckSeekingCapabilities, IltmmPlay::get_CurrentPosition, IltmmPlay::put_CurrentFramePosition, IltmmPlay::put_CurrentTrackingPosition

Topics:

Multimedia Function Group

Example

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

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