IDiscFormat2Data interface

Use this interface to write a data stream to a disc.

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

Methods

The IDiscFormat2Data interface has these methods.

Method Description
IDiscFormat2Data::CancelWrite Cancels the current write operation.
IDiscFormat2Data::get_BufferUnderrunFreeDisabled Determines if Buffer Underrun Free recording is enabled for CDR, CD-RW, and DVD-R media.
IDiscFormat2Data::get_ClientName Retrieves the friendly name of the client.
IDiscFormat2Data::get_CurrentMediaStatus Retrieves the current state of the media in the device.
IDiscFormat2Data::get_CurrentPhysicalMediaType Retrieves the type of media in the disc device.
IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV Retrieves the current rotational-speed control used by the recorder.
IDiscFormat2Data::get_CurrentWriteSpeed Retrieves the drive's current write speed.
IDiscFormat2Data::get_DisableConsumerDvdCompatibilityMode Determines if a DVD recording session includes tasks that can increase the chance that a device can play the DVD.
IDiscFormat2Data::get_ForceMediaToBeClosed Determines if further additions to the file system are prevented.
IDiscFormat2Data::get_ForceOverwrite Determines if the data writer must overwrite the disc on overwritable media types.
IDiscFormat2Data::get_FreeSectorsOnMedia Retrieves the number of free sectors on the disc for incremental recording (without overwriting existing data).
IDiscFormat2Data::get_LastWrittenAddressOfPreviousSession Retrieves the last sector of the previous write session.
IDiscFormat2Data::get_MultisessionInterfaces Retrieves a list of available multi-session interfaces.
IDiscFormat2Data::get_NextWritableAddress Retrieves the location for the next write operation.
IDiscFormat2Data::get_PostgapAlreadyInImage Determines if the data stream contains post-writing gaps.
IDiscFormat2Data::get_Recorder Retrieves the recording device to use for the write operation.
IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV Retrieves the requested rotational-speed control type.
IDiscFormat2Data::get_RequestedWriteSpeed Retrieves the requested write speed.
IDiscFormat2Data::get_StartAddressOfPreviousSession Retrieves the first sector of the previous write session.
IDiscFormat2Data::get_SupportedWriteSpeedDescriptors Retrieves a list of the detailed write configurations supported by the disc recorder and current media.
IDiscFormat2Data::get_SupportedWriteSpeeds Retrieves a list of the write speeds supported by the disc recorder and current media.
IDiscFormat2Data::get_TotalSectorsOnMedia Retrieves the number of sectors on the media in the device.
IDiscFormat2Data::get_WriteProtectStatus Retrieves the current write protect state of the media in the device.
IDiscFormat2Data::put_BufferUnderrunFreeDisabled Determines if Buffer Underrun Free recording is enabled.
IDiscFormat2Data::put_ClientName Sets the friendly name of the client.
IDiscFormat2Data::put_DisableConsumerDvdCompatibilityMode Determines if a DVD recording session includes tasks that can increase the chance that a device can play the DVD.
IDiscFormat2Data::put_ForceMediaToBeClosed Determines if further additions to the file system are prevented.
IDiscFormat2Data::put_ForceOverwrite Determines if the data writer must overwrite the disc on overwritable media types.
IDiscFormat2Data::put_PostgapAlreadyInImage Determines if the data stream contains post-writing gaps.
IDiscFormat2Data::put_Recorder Sets the recording device to use for the write operation.
IDiscFormat2Data::SetWriteSpeed Sets the write speed of the disc recorder.
IDiscFormat2Data::Write Writes the data stream to the device.

Remarks

To create the MsftDiscFormat2Data object in a script, use IMAPI2.MsftDiscFormat2Data 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

   
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

IDiscFormat2

IDiscFormat2Erase

IDiscFormat2RawCD

IDiscFormat2TrackAtOnce