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]

Public Function CdRippingAutomationInit (

nCdDriveIndex as Int16,

bSingleOutputFile as Boolean,

nSingleFileInterTrackSilence as Int32,

strSingleFileOutputPath as String

) as enumErrorCodes

[C#]

public enumErrorCodes CdRippingAutomationInit (

Int16 nCdDriveIndex,

Int16 bSingleOutputFile,

Int32 nSingleFileInterTrackSilence,

string strSingleFileOutputPath

);

[C++]

public: enumErrorCodes CdRippingAutomationInit (

Int16 nCdDriveIndex,

Int16 bSingleOutputFile,

Int32 nSingleFileInterTrackSilence,

string 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	Meaning
false	Each ripped track will be stored inside a separate file
true	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 "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 "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.