Copyright © 2006-2019 MultiMedia Soft

LoadSoundForPlayback method

Previous pageReturn to chapter overviewNext page

Remarks

 

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

 

Accepted stream formats are: MP1, MP2, MP3, MP4 (***), AIFF, AAC, M4A, AC3, FLAC, WavPack, ALAC, WAV, OGG Vorbis, OPUS, WMA (*),  ASF (**), WMV (**), AIFF, AU, W64, PAF, SVX, NIST, VOC, IRCAM, PVF and CAF.

 

Multichannel WAV, AIFF, OGG Vorbis, OPUS and WMA formats are not supported and will be resampled and 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.

 

 

Syntax

 

[Visual Basic]

control.LoadSoundForPlayback (

strPathname as string

) as enumErrorCodes


 

[C++]

short control.LoadSoundForPlayback (

LPCTSTR strPathname

);


 

 

Parameter

Description

 

 

strPathname

String representing the absolute pathname of the input file.

 

 

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.

 

(*) 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.

(**) Performs only sound tracks (no video): requires Microsoft Windows Media Format modules already installed on the target PC

(***) Performs only sound frames (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).