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 |