Copyright © 2006-2019 MultiMedia Soft

PositionMarkerAdd method

Previous pageReturn to chapter overviewNext page

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]

control.PositionMarkerAdd (

nUniqueId as long,

strDescription as string

) as enumErrorCodes


 

[C++]

short control.PositionMarkerAdd (

long nUniqueId,

LPCTSTR 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 error code meaning

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.