Methods > Audio format conversion > ConvertAutomationAddFile method

Remarks

Adds a sound file inside the conversion automation list that will be started at a later time through the ConvertAutomationExecute method. If you need to add the full contents of a specific folder, use the ConvertAutomationAddFolder method.

Sound files added to the conversion list can be enumerated at any time using the combination of ConvertAutomationGetFilesCount and ConvertAutomationGetFilePathname methods.

Accepted input 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).

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 ConvertFileDestResamplingSet method has been invoked with the nChannels parameter set to a number higher than 2 while in other cases will be converted to stereo during the conversion procedure.

Accepted MOD formats are: MOD, MTM, S3M, XM, IT and MO3.

Accepted CD audio tracks format is CDA.

For further information about sound files conversion see the How to convert format of sound files tutorial.

Syntax

[Visual Basic]

control.ConvertAutomationAddFile (

strSourcePathname as string

) as enumErrorCodes

[C++]

short control.ConvertAutomationAddFile (

LPCTSTR strSourcePathname

);

Parameter	Description

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

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