Remarks
Starts ripping the given CD track of the given CD drive.
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 details about the encoding format and parameters see the How to perform a CD ripping session section.
Syntax
[Visual Basic]
Public Function CdRippingStart (
nCdDriveIndex as Int16,
nTrackIndex as Int16,
strOutputPath as string
) as enumErrorCodes
|
|
[C#]
public enumErrorCodes CdRippingStart (
Int16 nCdDriveIndex,
Int16 nTrackIndex,
string strOutputPath
);
|
|
[C++]
public: enumErrorCodes CdRippingStart (
Int16 nCdDriveIndex,
Int16 nTrackIndex,
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.
|
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.
|
|
