PrimoBurner(tm) for C++  4.7
CD, DVD and Blu-ray Software Development Kit
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Pages
AudioCDCallback Class Reference

Implement this interface to receive progress notifications from AudioCD when writing or reading audio. More...

#include <PrimoBurnerAPI.h>

Inherits Reference.

Public Member Functions

virtual bool_t onContinueRead ()
 The onContinue method is called to check if the reading operation should continue. More...
 
virtual bool_t onContinueWrite ()
 The onContinueWrite method is called to check if the writing should continue. More...
 
virtual void onReadProgress (uint32_t current, uint32_t all)
 The onProgress method is called to report the number of blocks read from the CD. More...
 
virtual void onReadStatus (AudioCDStatus::Enum status)
 The onReadStatus method is called to report the status of the reading operation. More...
 
virtual void onWriteProgress (uint32_t current, uint32_t all)
 The onProgress method is called to report the number of blocks written to the CD. More...
 
virtual void onWriteStatus (AudioCDStatus::Enum status)
 The onWriteStatus method is called to report the status of the write operation. More...
 
virtual void onWriteTrack (int32_t trackIndex, int32_t percentWritten)
 The onTrackStatus method is called to report the write progress of individual tracks. More...
 
int32_t release () const
 Simple implementation of primo::Reference::release. More...
 
int32_t retain () const
 Simple implementation of primo::Reference::retain. More...
 
int32_t retainCount () const
 Simple implementation of primo::Reference::retainCount. More...
 

Detailed Description

Implement this interface to receive progress notifications from AudioCD when writing or reading audio.

See Also
AudioCD::setCallback
AudioCD::writeToCD
AudioCD::readTrackFromCD
AudioCD::readBlocksFromCD

Member Function Documentation

virtual bool_t onContinueRead ( )
virtual

The onContinue method is called to check if the reading operation should continue.

Returns
1 The reading should continue.
0 The reading should stop.
virtual bool_t onContinueWrite ( )
virtual

The onContinueWrite method is called to check if the writing should continue.

Returns
1 The writing should continue.
0 The writing should stop.
virtual void onReadProgress ( uint32_t  current,
uint32_t  all 
)
virtual

The onProgress method is called to report the number of blocks read from the CD.

Parameters
currentThe number of blocks that have been read from the CD.
allThe total number of blocks that will be read from the CD. This is always the size of the audio session in blocks.
Remarks
This method is called for every chunk read from the CD. This may be as frequently as 10 times per second. A minimal processing is recommended, otherwise the whole audio reading operation may slow significantly.
virtual void onReadStatus ( AudioCDStatus::Enum  status)
virtual

The onReadStatus method is called to report the status of the reading operation.

Parameters
status[in] Audio CD status.
virtual void onWriteProgress ( uint32_t  current,
uint32_t  all 
)
virtual

The onProgress method is called to report the number of blocks written to the CD.

Parameters
currentThe number of blocks that have been written to the CD.
allThe total number of blocks that will be written to the CD. This is always the size of the audio session in blocks.
virtual void onWriteStatus ( AudioCDStatus::Enum  status)
virtual

The onWriteStatus method is called to report the status of the write operation.

Parameters
statusAudio CD status.
virtual void onWriteTrack ( int32_t  trackIndex,
int32_t  percentWritten 
)
virtual

The onTrackStatus method is called to report the write progress of individual tracks.

Parameters
trackIndexThe zero based index of the track that is being written.
percentWrittenThe percentage of the track data that has been written to the CD.
int32_t release ( ) const
virtual

Simple implementation of primo::Reference::release.

Returns
The updated reference count.

Implements Reference.

int32_t retain ( ) const
virtual

Simple implementation of primo::Reference::retain.

Returns
The updated reference count.

Implements Reference.

int32_t retainCount ( ) const
virtual

Simple implementation of primo::Reference::retainCount.

Returns
The current reference count.

Implements Reference.