IRedbookDiscMaster interface (imapi.h)

The IRedbookDiscMaster interface enables the staging of an audio CD image. It represents one of the formats supported by MSDiscMasterObj, and it allows the creation of multi-track audio discs in Track-at-Once mode (fixed-size audio gaps).

Tracks are created in the stash file, data is added to them, and then they are closed. Only one track is staged at a time; this is called the open track. The remaining tracks are closed and committed to the image, while the open track has available to it all the blocks that are not in use by closed tracks.


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


The IRedbookDiscMaster interface has these methods.


Adds blocks of audio data to the currently open track. This method can be called repeatedly until there is no space available or the track is full.

Closes a currently open audio track. All audio tracks must be closed before the IDiscMaster::RecordDisc method can be called.

Begins staging a new audio track. It can be called only when there are no open audio tracks in the image.

Retrieves the size, in bytes, of an audio block.

Retrieves the current number of blocks that can be added to the track before an additional add will cause a failure for lack of space.

Retrieves the total number of blocks available for staging audio tracks. The total includes all block types, including blocks that may need to be allocated for track gaps.

Retrieves the total number of tracks that have either been staged or are being staged.

Retrieves the total number of audio blocks in use.


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