Methods > Position markers > PositionMarkerAddOffline method

Remarks

Adds a new position marker: differently from the PositionMarkerAdd method, which requires a live recording session, this method can be invoked when the recording session has already been stopped.

Although there is no limit to the number of position markers that can be added to a recording session, only one position marker can be added on a specific position. It's not allowed adding a position marker at position 0 of the recording session.

The number of available position markers can be retrieved at the end of the recording session through the PositionMarkerCountGet method.

For details about recording from input devices see the How to perform a recording session tutorial.

Syntax

[Visual Basic]

Public Function PositionMarkerAddOffline (

nUniqueId as Int32,

strDescription as string,

nPositionMs as Int32

) as enumErrorCodes

[C#]

public enumErrorCodes PositionMarkerAddOffline (

Int32 nUniqueId,

string strDescription,

Int32 nPositionMs

);

[C++]

public: enumErrorCodes PositionMarkerAddOffline (

Int32 nUniqueId,

string strDescription,

Int32 nPositionMs

);

Parameter	Description

nUniqueId	Number representing the unique identifier of the position marker.
strDescription	String representing the friendly description of the position marker
nPositionMs	The position, expressed in milliseconds, of the position marker

Return value

Value	Meaning

Negative value	An error occurred. Check the LastError property value in order to see the last error.
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.