Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
Inheritance
The IDiscFormat2TrackAtOnce interface inherits from IDiscFormat2. IDiscFormat2TrackAtOnce also has these types of members:
Methods
The IDiscFormat2TrackAtOnce interface has these methods.
| IDiscFormat2TrackAtOnce::AddAudioTrack Writes the data stream to the current media as a new track. |
| IDiscFormat2TrackAtOnce::CancelAddTrack Cancels the current write operation. (IDiscFormat2TrackAtOnce.CancelAddTrack) |
| IDiscFormat2TrackAtOnce::get_BufferUnderrunFreeDisabled Determines if Buffer Underrun Free recording is enabled. (IDiscFormat2TrackAtOnce.get_BufferUnderrunFreeDisabled) |
| IDiscFormat2TrackAtOnce::get_ClientName Retrieves the friendly name of the client. (IDiscFormat2TrackAtOnce.get_ClientName) |
| IDiscFormat2TrackAtOnce::get_CurrentPhysicalMediaType Retrieves the type of media in the disc device. (IDiscFormat2TrackAtOnce.get_CurrentPhysicalMediaType) |
| IDiscFormat2TrackAtOnce::get_CurrentRotationTypeIsPureCAV Retrieves the current rotational-speed control used by the recorder. (IDiscFormat2TrackAtOnce.get_CurrentRotationTypeIsPureCAV) |
| IDiscFormat2TrackAtOnce::get_CurrentWriteSpeed Retrieves the drive's current write speed. (IDiscFormat2TrackAtOnce.get_CurrentWriteSpeed) |
| IDiscFormat2TrackAtOnce::get_DoNotFinalizeMedia Determines if the media is left open for writing after writing the audio track. (Get) |
| IDiscFormat2TrackAtOnce::get_ExpectedTableOfContents Retrieves the table of content for the audio tracks that were laid on the media within the track-writing session. |
| IDiscFormat2TrackAtOnce::get_FreeSectorsOnMedia Retrieves the number of sectors available for adding a new track to the media. |
| IDiscFormat2TrackAtOnce::get_NumberOfExistingTracks Retrieves the number of existing audio tracks on the media. (IDiscFormat2TrackAtOnce.get_NumberOfExistingTracks) |
| IDiscFormat2TrackAtOnce::get_Recorder Retrieves the recording device to use for the write operation. (IDiscFormat2TrackAtOnce.get_Recorder) |
| IDiscFormat2TrackAtOnce::get_RequestedRotationTypeIsPureCAV Retrieves the requested rotational-speed control type. (IDiscFormat2TrackAtOnce.get_RequestedRotationTypeIsPureCAV) |
| IDiscFormat2TrackAtOnce::get_RequestedWriteSpeed Retrieves the requested write speed. (IDiscFormat2TrackAtOnce.get_RequestedWriteSpeed) |
| IDiscFormat2TrackAtOnce::get_SupportedWriteSpeedDescriptors Retrieves a list of the detailed write configurations supported by the disc recorder and current media. (IDiscFormat2TrackAtOnce.get_SupportedWriteSpeedDescriptors) |
| IDiscFormat2TrackAtOnce::get_SupportedWriteSpeeds Retrieves a list of the write speeds supported by the disc recorder and current media. (IDiscFormat2TrackAtOnce.get_SupportedWriteSpeeds) |
| IDiscFormat2TrackAtOnce::get_TotalSectorsOnMedia Retrieves the total sectors available on the media if writing one continuous audio track. |
| IDiscFormat2TrackAtOnce::get_UsedSectorsOnMedia Retrieves the total number of used sectors on the media. |
| IDiscFormat2TrackAtOnce::PrepareMedia Locks the current media for exclusive access. (IDiscFormat2TrackAtOnce.PrepareMedia) |
| IDiscFormat2TrackAtOnce::put_BufferUnderrunFreeDisabled Determines if Buffer Underrun Free Recording is enabled. |
| IDiscFormat2TrackAtOnce::put_ClientName Sets the friendly name of the client. (IDiscFormat2TrackAtOnce.put_ClientName) |
| IDiscFormat2TrackAtOnce::put_DoNotFinalizeMedia Determines if the media is left open for writing after writing the audio track. (Put) |
| IDiscFormat2TrackAtOnce::put_Recorder Sets the recording device to use for the write operation. (IDiscFormat2TrackAtOnce.put_Recorder) |
| IDiscFormat2TrackAtOnce::ReleaseMedia Closes the track-writing session and releases the lock. |
| IDiscFormat2TrackAtOnce::SetWriteSpeed Sets the write speed of the disc recorder. (IDiscFormat2TrackAtOnce.SetWriteSpeed) |
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
| 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 |