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.
|
|
