IDiscFormat2RawCD interface (imapi2.h)
Use this interface to write raw images to a disc device using Disc At Once (DAO) mode (also known as uninterrupted recording). For information on DAO mode, see the latest revision of the MMC specification at ftp://ftp.t10.org/t10/drafts/mmc5.
To create an instance of this interface, call the CoCreateInstance function. Use__uuidof(MsftDiscFormat2RawCD) for the class identifier and __uuidof(IDiscFormat2RawCD) for the interface identifier.
Inheritance
The IDiscFormat2RawCD interface inherits from IDiscFormat2. IDiscFormat2RawCD also has these types of members:
Methods
The IDiscFormat2RawCD interface has these methods.
| IDiscFormat2RawCD::CancelWrite Cancels the current write operation. (IDiscFormat2RawCD.CancelWrite) |
| IDiscFormat2RawCD::get_BufferUnderrunFreeDisabled Determines if Buffer Underrun Free recording is enabled. (IDiscFormat2RawCD.get_BufferUnderrunFreeDisabled) |
| IDiscFormat2RawCD::get_ClientName Retrieves the friendly name of the client. (IDiscFormat2RawCD.get_ClientName) |
| IDiscFormat2RawCD::get_CurrentPhysicalMediaType Retrieves the type of media in the disc device. (IDiscFormat2RawCD.get_CurrentPhysicalMediaType) |
| IDiscFormat2RawCD::get_CurrentRotationTypeIsPureCAV Retrieves the current rotational-speed control used by the recorder. (IDiscFormat2RawCD.get_CurrentRotationTypeIsPureCAV) |
| IDiscFormat2RawCD::get_CurrentWriteSpeed Retrieves the drive's current write speed. (IDiscFormat2RawCD.get_CurrentWriteSpeed) |
| IDiscFormat2RawCD::get_LastPossibleStartOfLeadout Retrieves the last possible starting position for the leadout area. |
| IDiscFormat2RawCD::get_Recorder Retrieves the recording device to use for the write operation. (IDiscFormat2RawCD.get_Recorder) |
| IDiscFormat2RawCD::get_RequestedRotationTypeIsPureCAV Retrieves the requested rotational-speed control type. (IDiscFormat2RawCD.get_RequestedRotationTypeIsPureCAV) |
| IDiscFormat2RawCD::get_RequestedSectorType Retrieves the requested data sector to use during write of the stream. |
| IDiscFormat2RawCD::get_RequestedWriteSpeed Retrieves the requested write speed. (IDiscFormat2RawCD.get_RequestedWriteSpeed) |
| IDiscFormat2RawCD::get_StartOfNextSession Retrieves the first sector of the next session. |
| IDiscFormat2RawCD::get_SupportedSectorTypes Retrieves the supported data sector types for the current recorder. |
| IDiscFormat2RawCD::get_SupportedWriteSpeedDescriptors Retrieves a list of the detailed write configurations supported by the disc recorder and current media. (IDiscFormat2RawCD.get_SupportedWriteSpeedDescriptors) |
| IDiscFormat2RawCD::get_SupportedWriteSpeeds Retrieves a list of the write speeds supported by the disc recorder and current media. (IDiscFormat2RawCD.get_SupportedWriteSpeeds) |
| IDiscFormat2RawCD::PrepareMedia Locks the current media for exclusive access. (IDiscFormat2RawCD.PrepareMedia) |
| IDiscFormat2RawCD::put_BufferUnderrunFreeDisabled Determines if Buffer Underrun Free recording is enabled. (IDiscFormat2RawCD.put_BufferUnderrunFreeDisabled) |
| IDiscFormat2RawCD::put_ClientName Sets the friendly name of the client. (IDiscFormat2RawCD.put_ClientName) |
| IDiscFormat2RawCD::put_Recorder Sets the recording device to use for the write operation. (IDiscFormat2RawCD.put_Recorder) |
| IDiscFormat2RawCD::put_RequestedSectorType Sets the requested data sector to use for writing the stream. |
| IDiscFormat2RawCD::ReleaseMedia Closes a Disc-At-Once (DAO) writing session of a raw image and releases the lock. |
| IDiscFormat2RawCD::SetWriteSpeed Sets the write speed of the disc recorder. (IDiscFormat2RawCD.SetWriteSpeed) |
| IDiscFormat2RawCD::WriteMedia Writes a DAO-96 raw image to the blank media using MSF 95:00:00 as the starting address. |
| IDiscFormat2RawCD::WriteMedia2 Writes a DAO-96 raw image to the blank media using a specified starting address. |
Remarks
To create the MsftDiscFormat2RawCD object in a script, use IMAPI2.MsftDiscFormat2RawCD as the program identifier when calling CreateObject.
It is possible for a power state transition to take place during a burn operation (i.e. user log-off or system suspend) which leads to the interruption of the burn process and possible data loss. For programming considerations, see Preventing Logoff or Suspend During a Burn.
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 |