Loads a sound from a given pathname for playback purposes only. After this call the sound is not available for editing or analysis purposes: for editing purposes you should use the LoadSound method.
The sound file can be a stream, a MOD music file or a CD audio track.
Accepted stream formats are: MP1, MP2, MP3, MP4 (***), AIFF, AAC, M4A, AC3, FLAC, WavPack, ALAC, WAV, OGG Vorbis, OPUS, WMA (*), ASF (**), WMV (**), W64, AU, PAF, SVX, NIST, VOC, IRCAM, PVF, CAF, Speex, Musepack, Monkey's Audio (APE), MIDI.
Formats wrapped inside a RIFF container (for example GSM 6.10, ADPCM, CCITT, etc. ) are supported if the specific ACM (Audio Compression Manager) codec is installed inside the system.
Multi-channel WAV, AIFF, OGG Vorbis, OPUS and WMA formats are supported natively when the MultiChannelLoadingModeSet method has been invoked with the nMode parameter set to MULTICHAN_DOWNMIX_NONE while in other cases will be converted to stereo during the loading procedure.
Accepted MOD formats are: MOD, MTM, S3M, XM, IT and MO3.
Accepted CD audio tracks format is CDA.
No event is generated by this method and the loaded sound file is immediately available for playback after the call.
(*) Requires Microsoft Windows Media Format modules already installed on the target PC: you can verify the presence of these modules through a call to the IsWmaAvailable method.
(**) Only sound stream supported (no video): requires Microsoft Windows Media Format modules already installed on the target PC
(***) Only sound stream supported (no video)
The Windows Media Format modules can be installed using the redistribution setup package (wmfdist.exe) provided by Microsoft. Details about the integration of these modules inside your own setup package can be found on the following link of the official Microsoft web site (note that in the future this link could change due to the Microsoft site maintenance).