IDiscMaster：：RecordDisc 方法 (imapi.h)

將暫存影像在作用中的光碟錄製器中將暫存影像轉換成媒體。

語法

HRESULT RecordDisc(
  [in] boolean bSimulate,
  [in] boolean bEjectAfterBurn
);

參數

[in] bSimulate

指出媒體是否已被消耗。 如果此參數為 TRUE，則作用中光碟錄製器中的媒體實際上不會被消耗。 相反地，會執行仿真的刻錄。 仿真是一個良好的光碟錄製器測試，因為大部分的作業都是以實際光頭執行。 如果此參數為 FALSE，則錄製器中的媒體實際上會被消耗。

[in] bEjectAfterBurn

指出是否要在用完之後退出媒體。 如果此參數為 TRUE，媒體就會退出。 如果此參數為 FALSE，媒體就不會退出。

傳回值

S_OK會在成功時傳回，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

備註

雖然使用 ProgressAdvise 方法註冊進度回呼，但這個方法會在處理完成時傳回。 任何錯誤都會導致這個方法傳回，此方法的一部分幾乎沒有修正動作。

在呼叫 RecordDisc 之後，暫存的影像數據無效。 這可讓應用程式執行媒體的模擬或實際消耗。 基於安全性，在成功完成此方法第一次呼叫之後，會自動清除隱藏檔案的內容。 必須重新儲存磁碟，才能再次加以還原。

RecordDisc 方法預期會使用音訊的空白媒體。 否則，可能需要清除媒體 (例如CD-RW磁碟驅動器中的CD-RW媒體) 。 請參閱 IDiscRecorder：：Erase。

SetActiveDiscRecorder 方法會決定設定時，作用中磁碟驅動器中是否有 IMAPI 多會話磁碟區。 如果是，IMAPI 會自動進入多會話模式。 如果在多會話模式中，且呼叫 RecordDisc，則建立多會話模式的相同光碟必須位於作用中錄製器中，否則會傳回IMAPI_E_WRONGDISC的錯誤碼。

規格需求

另請參閱

IDiscMaster