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

另请参阅

IDiscMaster