IDiscFormat2TrackAtOnce：：AddAudioTrack 方法 (imapi2.h)
將資料流程寫入目前媒體做為新播放軌。
語法
HRESULT AddAudioTrack(
[in] IStream *data
);
參數
[in] data
要寫入為媒體上下一個曲目之音訊資料的 IStream 介面。
資料格式包含 44.1KHz、16 位身歷聲、原始音訊範例。 這是 Microsoft WAV 音訊檔案中音訊範例所使用的相同格式， (不含標頭) 。
傳回值
S_OK會在成功時傳回，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：
| 傳回碼 | 描述 |
|---|---|
|
指標無效。
值：0x80004003 |
|
只有在媒體已「備妥」時，要求的作業才有效。
值：0xC0AA0502 |
|
目前有寫入作業正在進行中。
值：0xC0AA0500 |
|
CD-R 和 CD-RW 媒體最多支援 99 個曲目。
值：0xC0AA0508 |
|
提供的音訊資料流程無效。
值：0xC0AA050D |
|
媒體上沒有足夠的空間可新增提供的音訊播放軌。 值：0xC0AA0509 |
|
未指定的失敗。
值：0x80004005 |
|
一或多個引數無效。
值：0x80070057 |
|
無法配置所需的記憶體。
值：0x8007000E |
|
裝置無法在逾時期間內接受命令。 這可能是因為裝置進入不一致的狀態而造成，或者可能需要增加命令的逾時值。
值：0xC0AA020D |
|
裝置回報命令的非預期或無效資料。
值：0xC0AA02FF |
|
媒體會向下插入。
值：0xC0AA0204 |
|
磁片磁碟機回報它正在準備好。 請稍後再試一次要求。
值：0xC0AA0205 |
|
裝置中沒有媒體。
值：0xC0AA0202 |
|
媒體目前正在格式化。 請先等候格式完成，再嘗試使用媒體。
值：0xC0AA0206 |
|
磁片磁碟機回報正在執行長時間執行的作業，例如完成寫入。 磁片磁碟機可能長時間無法使用。
值：0xC0AA0207 |
|
寫入失敗，因為磁片磁碟機未快速收到足以繼續寫入的資料。 將來源資料移至本機電腦、減少寫入速度，或啟用 [緩衝區不足] 設定可能會解決此問題。
值：0xC0AA0300 |
|
媒體不相容或未知的實體格式。
值：0xC0AA0203 |
|
DVD 結構不存在。 這可能是因為使用的磁片磁碟機/媒體不相容所造成。
值：0xC0AA020E |
|
裝置回報要求的模式頁面 (，且類型) 不存在。
值：0xC0AA0201 |
|
磁片磁碟機報告不支援 MODE SELECT 命令在模式頁面中提供的參數組合。
值：0xC0AA0208 |
|
磁片磁碟機回報媒體受到寫入保護。
值：0xC0AA0209 |
|
媒體的速度與裝置不相容。 這可能是因為使用比裝置支援的速度範圍還要高或較低的速度媒體所造成。
值：0xC0AA020F |
|
指定的控制碼無效。
值：6 |
|
指定的網路資源或裝置已無法使用。
值：55 |
|
上次作業期間與此錄製器相關聯的裝置已獨佔鎖定，導致此作業失敗。
值：0xC0AA0210 |
|
已取消要求。
值：0xC0AA0002 |
備註
呼叫此方法之前，您必須呼叫 IDiscFormat2TrackAtOnce：:p ut_Recorder 和 IDiscFormat2TrackAtOnce：:P repareMedia 方法。
如果預設值不適合您的應用程式，您也應該考慮呼叫下列方法：
- IDiscFormat2TrackAtOnce：:p ut_BufferUnderrunFreeDisabled
- IDiscFormat2TrackAtOnce：:p ut_ClientName
- IDiscFormat2TrackAtOnce：:p ut_DoNotFinalizeMedia
媒體可以容納 99 個音訊資料軌。 追蹤編號從 1 開始。 最後一個曲目是 99。
無回應或包含零的資料範例會以下列方式新增至追蹤寫入作業：
- 追蹤大小下限為 4 秒，視需要放大追蹤資料以符合此需求。
- 由於一次播放軌的本質，連續音訊播放軌之間會新增兩秒的間距。 此差距通常由電腦型播放機隱藏，但在某些消費者電子設備上可能很明顯。
需求
| 最低支援的用戶端 | Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | imapi2.h |