IDiscMaster::SetActiveDiscMasterFormat 方法 (imapi.h)
设置当前活动的光盘录制器格式。 活动格式既指定暂暂图像文件内容 (音频/数据) 的结构,又指定用于操作该暂暂图像的 COM 接口。
语法
HRESULT SetActiveDiscMasterFormat(
[in] REFIID riid,
[out] void **ppUnk
);
parameters
[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 |
Library | Uuid.lib |
DLL | Actxprxy.dll |