Methods > 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, 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.

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

Public Function ConvertAutomationAddFolder (

strSourcePath as string,

bLookInSubFolders as Boolean

) as String

[C#]

public string ConvertAutomationAddFolder (

string strSourcePath,

bool bLookInSubFolders

);

[C++]

public: string ConvertAutomationAddFolder (

string strSourcePath,

bool 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
false	Don't look in sub-folders.
true	Look in sub-folders.

Return value

Value	Meaning

Empty string	An error occurred (see the LastError property for further error details)
Valid string	The formatted time