Methods > Position markers > PositionMarkerAdd method

Remarks

During a recording session, started from one between the StartFromDirectSoundDevice, StartFromAsioDevice, StartFromDjStudioMixer, StartFromWasapiCaptureDevice, StartFromWasapiLoopbackDevice or StartFromWasapiMixer methods, adds a new position marker using the current position of the live recording session. Position markers can be useful to easily retrieve a specific position after completing the recording session.

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.

When the recording session has been completed, you can still add further position markers through the PositionMarkerAddOffline method.

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 PositionMarkerAdd (

nUniqueId as Int32,

strDescription as string

) as enumErrorCodes

[C#]

public enumErrorCodes PositionMarkerAdd (

Int32 nUniqueId,

string strDescription

);

[C++]

public: enumErrorCodes PositionMarkerAdd (

Int32 nUniqueId,

string strDescription

);

Parameter	Description

nUniqueId	Number representing the unique identifier of the position marker.
strDescription	String representing the friendly description 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.