IDiscFormat2RawCD::WriteMedia method (imapi2.h)

Article
10/13/2021

Writes a DAO-96 raw image to the blank media using MSF 95:00:00 as the starting address.

Syntax

HRESULT WriteMedia(
  [in] IStream *data
);

Parameters

[in] data

An IStream interface of the data stream to write.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code	Description
E_POINTER	Pointer is not valid. Value: 0x80004003
E_IMAPI_DF2RAW_STREAM_NOT_SUPPORTED	The provided audio stream is not valid. Value: 0xC0AA060D
E_IMAPI_DF2RAW_MEDIA_IS_NOT_PREPARED	The requested operation is only valid when media has been "prepared". Value: 0xC0AA0602
E_IMAPI_DF2RAW_WRITE_IN_PROGRESS	There is currently a write operation in progress. Value: 0xC0AA0600
E_IMAPI_DF2RAW_MEDIA_IS_NOT_BLANK	Only blank CD-R/RW media is supported. Value: 0xC0AA0606
E_IMAPI_DF2RAW_STREAM_LEADIN_TOO_SHORT	The stream does not contain a sufficient number of sectors in the leadin for the current media. Value: 0xC0AA060F
E_INVALIDARG	One or more arguments are not valid. Value: 0x80070057
E_IMAPI_DF2RAW_NOT_ENOUGH_SPACE	There is not enough space on the media to add the provided session. Value: 0xC0AA0609
E_FAIL	Unspecified failure. Value: 0x80004005
E_OUTOFMEMORY	Failed to allocate the required memory. Value: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	The device failed to accept the command within the timeout period. This may be caused by the device having entered an inconsistent state, or the timeout value for the command may need to be increased. Value: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	The device reported unexpected or invalid data for a command. Value: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	The media is inserted upside down. Value: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	The drive reported that it is in the process of becoming ready. Please try the request again later. Value: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	There is no media in the device. Value: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	The media is currently being formatted. Please wait for the format to complete before attempting to use the media. Value: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	The drive reported that it is performing a long-running operation, such as finishing a write. The drive may be unusable for a long period of time. Value: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	The write failed because the drive did not receive data quickly enough to continue writing. Moving the source data to the local computer, reducing the write speed, or enabling a "buffer underrun free" setting may resolve this issue. Value: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	The media is not compatible or of unknown physical format. Value: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	The DVD structure is not present. This may be caused by incompatible drive/medium used. Value: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	The device reported that the requested mode page (and type) is not present. Value: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	The drive reported that the combination of parameters provided in the mode page for a MODE SELECT command were not supported. Value: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	The drive reported that the media is write protected. Value: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	The media's speed is incompatible with the device. This may be caused by using higher or lower speed media than the range of speeds supported by the device. Value: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	The specified handle is invalid. Value: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	The specified network resource or device is no longer available. Value: 55
E_IMAPI_RECORDER_LOCKED	The device associated with this recorder during the last operation has been exclusively locked, causing this operation to failed. Value: 0xC0AA0210
E_IMAPI_REQUEST_CANCELLED	The request was canceled. Value: 0xC0AA0002

Remarks

Before calling this method, you must call the IDiscFormat2RawCD::put_Recorder and IDiscFormat2RawCD::PrepareMedia methods.

You should also consider calling the following methods if their default values are not appropriate for your application:

This method is synchronous. To determine the progress of the write operation, you must implement the DDiscFormat2RawCDEvents interface. For examples that show how to implement an event handler in a script, see Monitoring Progress With Events.

The first sector of the raw image is written at MSF 95:00:00. If your RAW image has a different first sector, please use the IDiscFormat2RawCD::WriteMedia2 method.

This method uses the IStream::Seek method to reach the appropriate starting location in the image for the current media. If the IStream::Seek method fails, the method will call the IStream::Read method repeatedly until reaching the starting sector.

The DAO-96 standard allows writing of any type of data to CD media. One common usage is to write audio CDs without a 2-second gap between tracks.

DAO-96 also supports variations in the subcode content, such as CD+G and CD-Text.

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