This topic has not yet been rated - Rate this topic

IDiscFormat2TrackAtOnce interface

Use this interface to write audio to blank CD-R or CD-RW media in Track-At-Once mode.

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

Members

The IDiscFormat2TrackAtOnce interface inherits from IDiscFormat2. IDiscFormat2TrackAtOnce also has these types of members:

Methods

Methods

The IDiscFormat2TrackAtOnce interface has these methods.

Method	Description
AddAudioTrack	Writes the data stream to the current media as a new track.
CancelAddTrack	Cancels adding the new track to the media.
get_BufferUnderrunFreeDisabled	Determines if Buffer Underrun Free Recording is enabled.
get_ClientName	Retrieves the friendly name of the client.
get_CurrentPhysicalMediaType	Retrieves the type of media in the disc device.
get_CurrentRotationTypeIsPureCAV	Retrieves the rotational-speed control used by the recorder.
get_CurrentWriteSpeed	Retrieves the drive's current write speed.
get_DoNotFinalizeMedia	Determines if the media is left open for writing after writing the audio track.
get_ExpectedTableOfContents	Retrieves the table of content for the audio tracks that were laid on the media within the track-writing session.
get_FreeSectorsOnMedia	Retrieves the number of sectors available for adding a new track to the media.
get_NumberOfExistingTracks	Retrieves the number of existing audio tracks on the media.
get_Recorder	Retrieves the recording device to use for the write operation.
get_RequestedRotationTypeIsPureCAV	Retrieves the requested rotational-speed control type.
get_RequestedWriteSpeed	Retrieves the requested write speed.
get_SupportedWriteSpeedDescriptors	Retrieves a list of the detailed write configurations supported by the disc recorder and current media.
get_SupportedWriteSpeeds	Retrieves a list of the write speeds supported by the disc recorder and current media.
get_TotalSectorsOnMedia	Retrieves the total sectors available on the media if writing one continuous audio track.
get_UsedSectorsOnMedia	Retrieves the total number of used sectors on the media.
PrepareMedia	Locks the current media for exclusive access.
put_BufferUnderrunFreeDisabled	Determines if Buffer Underrun Free Recording is enabled.
put_ClientName	Sets the friendly name of the client.
put_DoNotFinalizeMedia	Determines if the media is left open for writing after writing the audio track.
put_Recorder	Sets the recording device to use for the write operation.
ReleaseMedia	Closes the track-writing session and releases the lock.
SetWriteSpeed	Sets the write speed of the attached disc recorder.

Remarks

To create the MsftDiscFormat2TrackAtOnce object in a script, use IMAPI2.MsftDiscFormat2TrackAtOnce 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]
IDL	Imapi2.idl

Community Additions