Remarks
Loads a song from the specified file and, if Stereo, converts it to Mono.
Accepted stream formats are MP1, MP2 and MP3 (Stereo and Mono): trying to load any other Stereo format will fail. If the song is already in Mono, this method will load any other format supported by the LoadSound method
A successful call to this method will fire the SoundLoaded event.
Syntax
[C++]
short control.LoadSoundInMono (
short nPlayer,
LPCTSTR strFileName,
short bFast
);
|
|
Parameter
|
Description
|
|
|
nPlayer
|
Number representing the zero-based index of the player that will load the sound
|
strFilename
|
String containing the absolute pathname of the song file to load. It can be a full path name (ex. c:\mysounds\sound.mp3) or a filename (ex: sound.mp3) if the SoundsDirectory property has already been specified.
|
bFast
|
Flag that determines if a less detailed analysis must be performed for files in MP3 format: the use of this method is indicated when you need an immediate loading of MP3 files from a network.
|
Return value
Value
|
Meaning
|
|
|
enumErrorCodes.NOERROR (0)
|
The song file has been loaded successfully.
|
Negative value
|
An error occurred: see the LastError property for further error details or for a list of the possible error values.
|
|