通过

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错误代码。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi.h
Library Uuid.lib
DLL Actxprxy.dll

另请参阅

IDiscMaster