|
CdRippingAutomationExec method |
  
|
|
CdRippingAutomationExec method |
|
Remarks
Starts the CD ripping automation session.
The ripping automation must have been previously initialized through the CdRippingAutomationInit method and one or more tracks should have been added through the CdRippingAutomationTrackAdd method.
If tracks normalization is disabled, the container application is notified about the CD ripping automation session through the CallbackForRecordersEvents delegate which is invoked with the nEvent parameter set to the following values:
| • | EV_CD_RIPPING_AUTOMATION_START invoked once at the beginning |
| • | EV_CD_RIPPING_PERC invoked multiple times reporting the current advancement percentage of each single track inside the nDataLow3 parameter |
| • | EV_CD_RIPPING_AUTOMATION_TOTAL_PERC invoked multiple times reporting the advancement of the overall ripping automation session |
| • | EV_CD_RIPPING_SIZE invoked multiple times reporting the current size in bytes of each single track inside the combination of the nDataHigh3 and nDataLow3 parameters |
| • | EV_CD_RIPPING_AUTOMATION_STOP invoked as soon as the ripping automation session is completed |
If tracks normalization should be enabled through a previous call to the CdRippingNormalizationEnable method, the call to this method would cause the CallbackForRecordersEvents delegate to be invoked with the nEvent parameter having the same values described above but also with the following values:
| • | EV_CD_RIPPING_EXTRACT_PERC event informs the container application about the advancement of extraction of the CD track's raw sound data into a memory buffer (see point 1. above) |
| • | EV_CD_RIPPING_NORM_PERC event informs the container application about the normalization advancement (see point 2. above) |
| • | EV_CD_RIPPING_ENCODE_PERC event informs the container application about the encoding advancement (see point 3. above) |
For details about the encoding format and parameters see the How to perform a CD ripping session section.
Syntax
[Visual Basic] Public Function CdRippingAutomationExec ( ) as enumErrorCodes |
[C#] public enumErrorCodes CdRippingAutomationExec ( ); |
[C++] public: enumErrorCodes CdRippingAutomationExec ( ); |
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. |
