iWriteEngine2 接口 (imapi2.h)

项目
08/24/2023

使用此接口将数据流写入设备。

开发对新媒体类型或格式的支持的人员应使用此接口。写入媒体通常包括以下步骤：

通过设置媒体的模式页来准备硬件。
查询硬件以验证媒体是否足够大。
初始化写入，例如，通过设置媒体格式或设置 OPC。
执行实际的 WRITE 命令。
通过停止格式设置或关闭会话或轨道完成写入。

开发对新媒体类型的支持时，可以实现步骤 1、2、3 和 5，并使用此接口执行步骤 4。请注意，所有 IDiscFormat2* 接口都使用此接口执行写入操作。

大多数客户端应用程序应使用 IDiscFormat2Data 接口将映像写入设备。

若要创建此接口的实例，请调用 CoCreateInstance 函数。 Use__uuidof (类标识符的 MsftWriteEngine2) ，接口标识符__uuidof (IWriteEngine2) 。

继承

IWriteEngine2 接口继承自 IDispatch 接口。 IWriteEngine2 还具有以下类型的成员：

方法

IWriteEngine2 接口具有这些方法。


IWriteEngine2：：CancelWrite 取消正在进行的写入操作。
IWriteEngine2：：get_BytesPerSector 检索写入过程中要用于每个扇区的字节数。返回的值指示之前使用 IWriteEngine2：:p ut_BytesPerSector 设置的值，并且不会为媒体返回每个扇区值的当前字节。
IWriteEngine2：：get_EndingSectorsPerSecond 检索记录设备在写入过程结束时每秒可以写入媒体的估计扇区数。
IWriteEngine2：：get_Recorder 检索要用于写入操作的录制设备。
IWriteEngine2：：get_StartingSectorsPerSecond 检索记录设备在写入过程开始时每秒可以写入媒体的估计扇区数。
IWriteEngine2：：get_UseStreamingWrite12 检索一个值，该值指示写入操作是使用 WRITE12 还是 WRITE10 命令。
IWriteEngine2：：get_WriteInProgress 检索一个值，该值指示记录器当前是否正在将数据写入光盘。
IWriteEngine2：:p ut_BytesPerSector 设置写入期间要用于每个扇区的字节数。
IWriteEngine2：:p ut_EndSectorsPerSecond 设置记录设备在写入过程结束时每秒可以写入媒体的估计扇区数。
IWriteEngine2：:p ut_Recorder 设置写入操作的记录设备。
IWriteEngine2：:p ut_StartingSectorsPerSecond 设置记录设备在写入过程开始时每秒可以写入媒体的估计扇区数。
IWriteEngine2：:p ut_UseStreamingWrite12 设置一个值，该值指示写入操作是使用 WRITE12 还是 WRITE10 命令。
IWriteEngine2：：WriteSection 将数据流写入当前记录器。

注解

若要在脚本中创建 MsftWriteEngine2 对象，请使用 IMAPI2。调用 CreateObject 时，MsftWriteEngine2 作为程序标识符。

在烧毁操作期间可能会发生电源状态转换， (即用户注销或系统暂停) 这会导致烧毁过程的中断和可能的数据丢失。有关编程注意事项，请参阅防止在燃烧期间注销或挂起。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi2.h