The DeviceCallback interface lets you receive progress notifications for long read operations like cue sheet reading, progress notifications for erase and format operations and progress notifications for lead-in/lead-out recording.
More...
#include <PrimoBurnerAPI.h>
Inherits Reference.
The DeviceCallback interface lets you receive progress notifications for long read operations like cue sheet reading, progress notifications for erase and format operations and progress notifications for lead-in/lead-out recording.
| virtual bool_t onContinueReading |
( |
| ) |
|
|
virtual |
The onContinueReading method is called by a Device instance to check if a long read operation should continue.
- Returns
- 1 The reading should continue.
-
0 The reading should be aborted.
| virtual void onEraseProgress |
( |
double |
progress | ) |
|
|
virtual |
The onEraseProgress method is called by an Device instance to report the progress of a blanking operation started with the Device::eraseEx method.
The onEraseProgress method is called from a thread different from the thread the Device::eraseEx method has been called.
- Parameters
-
| progress | A percentage value showing the progress of the current blanking operation. |
IMPORTANT: Some devices do not report the blanking progress properly. For those devices this method is called twice - once with progress = 0.0% in the beginning and once with dProgress = 100.0% at the end of the blanking operation.
| virtual void onFormatProgress |
( |
double |
progress | ) |
|
|
virtual |
The onFormatProgress method is called by an Device instance to report the progress of a format operation started with the Device::format method.
The onFormatProgress method is called on a thread different than the one on which Device::format has been called.
- Parameters
-
| progress | A percentage value showing the progress of the current format operation. |
| virtual void onRead |
( |
int32_t |
startLba, |
|
|
int32_t |
endLba, |
|
|
int32_t |
currentLba, |
|
|
uint32_t |
blocks |
|
) |
| |
|
virtual |
The onRead method is called to report the progress of a long read operation.
- Parameters
-
| startLba | The logical block address from which the reading started. |
| endLba | The logical block address of the last block that will be read. |
| currentLba | The logical block address after the last read cycle. |
| blocks | Number of blocks read with the last read cycle. |
| virtual void onWriteLeadIn |
( |
uint32_t |
blocks, |
|
|
uint32_t |
allBlocks |
|
) |
| |
|
virtual |
The onWriteLeadIn method is called to report the progress during the recording of the lead in area of a CD session when RAW CD writing is used.
NOTE: The lead-in area is written directly by PrimoBurner only when all of the following conditions are met:
- The medium is a CD.
- The write method is RawDao, RawDao2352 or FullRawDao.
- The burner device supports RAW CD writing (CDFeatures::canWriteRawDao() is TRUE). In all other cases this notification is not raised.
- Parameters
-
| blocks | The number of blocks that have been written. |
| allBlocks | The total number of blocks that will be written. |
| virtual void onWriteLeadOut |
( |
uint32_t |
blocks, |
|
|
uint32_t |
allBlocks |
|
) |
| |
|
virtual |
The onWriteLeadOut method is called to report the progress during the recording of the lead out area of a CD session when RAW CD writing is used.
NOTE: The lead-out area is written directly by PrimoBurner only when all of the following conditions are met:
- The medium is a CD.
- The write method is RawDao, RawDao2352 or FullRawDao.
- The burner device supports RAW CD writing (CDFeatures::canWriteRawDao() is TRUE). In all other cases this notification is not raised.
- Parameters
-
| blocks | The number of blocks that have been written. |
| allBlocks | The total number of blocks that will be written. |
| int32_t release |
( |
| ) |
const |
|
virtual |
| int32_t retainCount |
( |
| ) |
const |
|
virtual |
