Methods > Audio format conversion > ConvertAutomationAddFolder method

Remarks

Adds all sound files contained inside a folder inside the conversion automation list that will be started at a later time through the ConvertAutomationExecute 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.ConvertAutomationAddFolder (

strSourcePath as string,

bLookInSubFolders as enumBoolean

) as enumErrorCodes

[C++]

short control.ConvertAutomationAddFolder (

LPCTSTR strSourcePath,

short bLookInSubFolders

);

Parameter

Description

strSourcePath

String representing the absolute path of the folder where source sound files to add are stored

bLookInSubFolders

Boolean value that tells if files enumeration must look in sub-folders also.

Supported values are the following:

Mnemonic Value	Meaning
BOOL_FALSE	Don't look in sub-folders.
BOOL_TRUE	Look in sub-folders.

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