Remarks
Loads position markers, previously saved through the PositionMarkerSave method, from an existing XML file or, if supported by the audio format of the latest sound file recorded through the StartFromFile method, directly from the file's tags.
For details about recording from input devices see the How to perform a recording session tutorial.
Syntax
[Visual Basic]
control.PositionMarkerLoad (
strPathname as string
) as enumErrorCodes
|
|
[C++]
short control.PositionMarkerLoad (
LPCTSTR strPathname
);
|
|
Parameter
|
Description
|
|
|
strPathname
|
String containing the absolute pathname of the source XML file or an empty string to indicate a different behaviour:
| • | if the string contains an absolute pathname, position markers are loaded from the given file |
| • | if the string is empty and the audio format of the latest recorded sound file is one of the following, position markers are loaded from 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 audio format of the latest recorded sound file is not on the list above, position markers are automatically loaded from a XML file having exactly the same pathname and filename of the sound file but with extension ".XML"; if for example the loaded sound file should be in WAV format having pathname "C:\myfolder\file.wav", the corresponding position markers file would be loaded from "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.
|
|
