IDiscMaster：：SetActiveDiscMasterFormat 方法 (imapi.h)

設定目前使用中的光碟錄製器格式。 使用中格式會指定暫存影像檔內容的結構 (音訊/資料) ，以及必須用來操作該分段影像的 COM 介面。

語法

HRESULT SetActiveDiscMasterFormat(
  [in]  REFIID riid,
  [out] void   **ppUnk
);

參數

[in] riid

目前使用中格式的 IID。

[out] ppUnk

新磁片格式之 COM 介面的指標。

傳回值

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

備註

這個方法的成功呼叫會清除目前暫存影像的內容。 此外，它可能會變更支援的磁片錄製器清單。 這是因為並非所有錄製器都支援所有格式。 錄製器清單的變更會透過 IDiscMasterProgressEvents：：NotifyPnPActivity宣告。 如果目前選取的錄製器不是新一組支援裝置的成員，則第一次呼叫 Open) 之後，將不會再有作用中的錄製器 (類似狀態。 在此情況下，應用程式必須先選取新的使用中錄製器，才能起始錄製。

MSDiscMasterObj 僅支援下列 IID：IID_IRedbookDiscMaster (IRedbookDiscMaster) 和 IID_IJolietDiscMaster (IJolietDiscMaster) 。 如果沒有設定格式，則預設值為 Joliet 格式。 每個應用程式都負責透過 使用 EnumDiscMasterFormats 和此方法來選取格式主機。

需求

另請參閱

IDiscMaster