IDiscMasterProgressEvents interface (imapi.h)

The IDiscMasterProgressEvents interface provides a single interface for all callbacks that can be made from IMAPI to an application. An application implements this interface on one of its objects and then registers it using IDiscMaster::ProgressAdvise. All but one of the methods in this interface are related to progress during staging or burns. Even if an application is not interested in a particular callback, it must implement the callback function and return E_NOTIMPL on the call.

Inheritance

The IDiscMasterProgressEvents interface inherits from the IUnknown interface. IDiscMasterProgressEvents also has these types of members:

Methods

The IDiscMasterProgressEvents interface has these methods.

IDiscMasterProgressEvents::NotifyAddProgress Notifies an application of its progress in response to calls to IRedbookDiscMaster::AddAudioTrackBlocks or IJolietDiscMaster::AddData. Notifications are sent for the first and last steps, and at points in between.
IDiscMasterProgressEvents::NotifyBlockProgress Notifies an application of its progress in burning a disc on the active recorder. Notifications are sent for the first and last blocks, and at points in between.
IDiscMasterProgressEvents::NotifyBurnComplete Notifies an application that a call to IDiscMaster::RecordDisc has finished.
IDiscMasterProgressEvents::NotifyClosingDisc Notifies the application that it is has started closing the disc. No further notifications are sent until the burn is finished.
IDiscMasterProgressEvents::NotifyEraseComplete Notifies an application that a call to IDiscRecorder::Erase has finished.
IDiscMasterProgressEvents::NotifyPnPActivity Notifies the application that there is a change to the list of valid disc recorders. (For example, a USB CD-R driver is removed from the system.).
IDiscMasterProgressEvents::NotifyPreparingBurn Notifies the application that it is preparing to burn a disc. No further notifications are sent until the burn starts.
IDiscMasterProgressEvents::NotifyTrackProgress Notifies an application that a track has started or finished during the burn of an audio disc.
IDiscMasterProgressEvents::QueryCancel Checks whether an AddData, AddAudioTrackBlocks, or RecordDisc operation should be canceled.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi.h