IDiscFormat2TrackAtOnce interface (imapi2.h)
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 |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for