Copyright © 2006-2018 MultiMedia Soft

CdRippingStartUsingCodec method

Previous pageReturn to chapter overviewNext page

Remarks

 

Starts ripping the given CD track of the given CD drive using the given Audio Compression Manager codec and format.

 

A successful call to this method will cause the CallbackForRecordersEvents delegate to be invoked with the nEvent parameter set to the following values:

 

EV_CD_RIPPING_START invoked once at the beginning
EV_CD_RIPPING_PERC invoked multiple times reporting the current advancement percentage inside the nDataLow3 parameter
EV_CD_RIPPING_SIZE invoked multiple times reporting the current size in bytes inside the combination of the nDataHigh3 and nDataLow3 parameters
EV_CD_RIPPING_STOP invoked as soon as the ripping session is completed

For further details about the Windows Audio Compression Manager refer to the AudioComprMan class  section.

For a tutorial about the use of the Windows Audio Compression Manager refer to the How to use the Windows Audio Compression Manager section.

See the How to perform a CD ripping session section for further details.

 

 

Syntax

 

[Visual Basic]

Public Function CdRippingStartUsingCodec (

nCdDriveIndex as Int16,

nTrackIndex as Int16,

nCodecIndex as Int16,

nCodecFormatIndex as Int16,

strOutputPath as string

) as enumErrorCodes


 

[C#]

public enumErrorCodes CdRippingStartUsingCodec (

Int16 nCdDriveIndex,

Int16 nTrackIndex,

Int16 nCodecIndex,

Int16 nCodecFormatIndex,

string strOutputPath

);


 

[C++]

public: enumErrorCodes CdRippingStartUsingCodec (

Int16 nCdDriveIndex,

Int16 nTrackIndex,

Int16 nCodecIndex,

Int16 nCodecFormatIndex,

string strOutputPath

);


 

 

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.

nTrackIndex

Number representing the one-based index of the CD audio track.

The total number of available audio tracks on the given CD can be obtained using the GetCdNumTracks method.

nCodecIndex

Number representing the index of the ACM codec.

 

Installed codecs can be enumerated using the AudioCompressionManager.GetCodecsCount method and their friendly description can be retrieved through the AudioCompressionManager.GetCodecDesc method.

nCodecFormatIndex

Number representing the index of the format for the given ACM codec.

 

Available formats for the given codec can be enumerated using the AudioCompressionManager.GetCodecFormatsCount method and their friendly description can be retrieved through the AudioCompressionManager.GetCodecFormatDesc method.

strOutputPath

String representing the absolute pathname of the output file that will contain the song's ripped data. If this pathname should contain invalid characters, they would be automatically changed into an underscore '_' character.

 

 

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.