IRawCDImageCreator interface (imapi2.h)

Use this interface to create a RAW CD image for use in writing to CD media in Disc-at-Once (DAO) mode. Images created with this interface can be written to CD media using the IDiscFormat2RawCD interface.

To create an instance of this interface, call the CoCreateInstance function. Use__uuidof(MsftRawCDImageCreator) for the class identifier and __uuidof(IRawCDImageCreator) for the interface identifier.

Inheritance

The IRawCDImageCreator interface inherits from the IDispatch interface. IRawCDImageCreator also has these types of members:

Methods

The IRawCDImageCreator interface has these methods.

 
IRawCDImageCreator::AddSpecialPregap

Accepts the provided IStream object and saves the associated pointer to be used as data for the pre-gap for track 1.
IRawCDImageCreator::AddSubcodeRWGenerator

Allows the addition of custom R-W subcode, provided by the IStream. The provided object must have a size equal to the number of sectors in the raw disc image * 96 bytes when the final image is created.
IRawCDImageCreator::AddTrack

Accepts the provided IStream object and saves the interface pointer as the next track in the image.
IRawCDImageCreator::CreateResultImage

Creates the final IStream object based on the current settings.
IRawCDImageCreator::get_DisableGaplessAudio

Retrieves the current value that specifies if "Gapless Audio" recording is disabled. This property defaults to a value of VARIANT_FALSE, which disables the use of "gapless" recording between consecutive audio tracks.
IRawCDImageCreator::get_ExpectedTableOfContents

Gets the SCSI-form table of contents for the resulting disc.
IRawCDImageCreator::get_LastUsedUserSectorInImage

Retrieves the number of total used sectors on the current media, including any overhead between existing tracks.
IRawCDImageCreator::get_MediaCatalogNumber

Sets the Media Catalog Number (MCN) for the entire audio disc.
IRawCDImageCreator::get_NumberOfExistingTracks

Retrieves the number of existing audio tracks on the media. (IRawCDImageCreator.get_NumberOfExistingTracks)
IRawCDImageCreator::get_ResultingImageType

Retrieves the value that specifies the type of image file that will be generated.
IRawCDImageCreator::get_StartingTrackNumber

Retrieves the starting track number.
IRawCDImageCreator::get_StartOfLeadout

Retrieves the value that defines the LBA for the start of the Leadout. This method can be utilized to determine if the image can be written to a piece of media by comparing it against the LastPossibleStartOfLeadout for the media.
IRawCDImageCreator::get_StartOfLeadoutLimit

Retrieves the current StartOfLeadoutLimit property value. This value specifies if the resulting image is required to fit on a piece of media with a StartOfLeadout greater than or equal to the LBA.
IRawCDImageCreator::get_TrackInfo

Retrieves an indexed property, which takes a LONG value with a range of 1 to 99 as the index to determine which track the user is querying. The returned object is then queried/set for the particular per-track property of interest.
IRawCDImageCreator::put_DisableGaplessAudio

Sets the value that specifies if "Gapless Audio" recording is disabled. This property defaults to a value of VARIANT_FALSE, which disables the use of "gapless" recording between consecutive audio tracks.
IRawCDImageCreator::put_MediaCatalogNumber

Retrieves the Media Catalog Number (MCN) for the entire audio disc.
IRawCDImageCreator::put_ResultingImageType

Sets the value that defines the type of image file that will be generated.
IRawCDImageCreator::put_StartingTrackNumber

Sets the starting track number.
IRawCDImageCreator::put_StartOfLeadoutLimit

Sets the StartOfLeadoutLimit property value.

Remarks

Images created with this interface can be written to persistent storage for later use, or can be provided directly to the IDiscFormat2RawCD interface for writing to CD media.

DVD media does not support this type of writing.

This interface is supported in Windows Server 2003 with Service Pack 1 (SP1), Windows XP with Service Pack 2 (SP2), and Windows Vista via the Windows Feature Pack for Storage. All features provided by this update package are supported natively in Windows 7 and Windows Server 2008 R2.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2.h

See also

IMAPI_CD_SECTOR_TYPE