Copyright © 2006-2018 MultiMedia Soft

PositionMarkerSave method

Previous pageReturn to chapter overviewNext page

Remarks

 

Saves existing position markers added during the latest recording session into a destination file in XML format or, if supported by the output audio format of the recoding session, directly into the file's tags. Saved position markers can be loaded at a later time through the PositionMarkerLoad method.

 

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

 

 

Syntax

 

[Visual Basic]

control.PositionMarkerSave (

strPathname as string

) as enumErrorCodes


 

[C++]

short control.PositionMarkerSave (

LPCTSTR strPathname

);


 

 

Parameter

Description

 

 

strPathname

String containing the absolute pathname of the destination XML file or an empty string to indicate a different behaviour:

if the string contains an absolute pathname, position markers are stored inside the given file
if the string is empty and the output audio format is one of the following, position markers are stored inside a comment field of the tag:

- MP3 (stored inside a COMM field of the ID3V2 tag)

- OGG Vorbis

- WMA

- MP4

- FLAC

if the string is empty and the output audio format is not on the list above, position markers are stored inside a XML file having exactly the same pathname and filename of the audio file being recorded but with extension ".XML"; if for example the recording session should be in WAV format and the output pathname should be set to "C:\myfolder\file.wav", the corresponding position markers file would be saved to "C:\myfolder\file.xml"

 

 

 

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.