Methods > CD drives and ripping > CdRippingAutomationInit method

Remarks

Initializes a CD ripping automation session.

Once initialized you can start adding CD tracks to the automation session through the CdRippingAutomationTrackAdd method and, at a later stage, the automation can be started through the CdRippingAutomationExec method.

For details about the encoding format and parameters see the How to perform a CD ripping session section.

Syntax

[Visual Basic]

control.CdRippingAutomationInit (

nCdDriveIndex as Integer,

bSingleOutputFile as enumBoolean,

nSingleFileInterTrackSilence as Long,

strSingleFileOutputPath as String

) as enumErrorCodes

[C++]

short control.CdRippingAutomationInit (

short nCdDriveIndex,

short bSingleOutputFile,

long nSingleFileInterTrackSilence,

LPCTSTR strSingleFileOutputPath

);

Parameter

Description

nCdDriveIndex

Number representing the zero-based index of the involved CD drive.

Installed CD drives can be enumerated using the GetCdDrivesCount method and their friendly description can be retrieved through the GetCdDriveDesc method.

bSingleOutputFile

Boolean flag that determines if ripped CD tracks will be stored inside a single output file or inside one output file for each track.

Supported values are the following:

Mnemonic constant	Value	Meaning
BOOL_FALSE	0	Each ripped track will be stored inside a separate file
BOOL_TRUE	1	All ripped tracks will be stored inside a single output file

nSingleFileInterTrackSilence

Length of silence, expressed in milliseconds, added between each ripped track when the bSingleOutputFile parameter is set to BOOL_TRUE and ripped tracks are stored inside a single output file.

strSingleFileOutputPath

String representing the absolute pathname of the single output file. This parameter is ignored when the bSingleOutputFile parameter is set to BOOL_FALSE in which case the string representing the absolute pathname of each output file is initialized through the strOutputPath parameter of the CdRippingAutomationTrackAdd method.

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The call was successful.