設定目前使用中的光碟錄製器格式。 使用中格式會指定暫存影像檔內容的結構 (音訊/資料) ,以及必須用來操作該分段影像的 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 和此方法來選取格式主機。
注意 呼叫此方法可能會變更可用的錄製器清單。 如需詳細資訊,請參閱 EnumDiscRecorders 的一節。
需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | imapi.h |
| 程式庫 | Uuid.lib |
| Dll | Actxprxy.dll |