iWriteEngine2 接口 (imapi2.h)
使用此接口将数据流写入设备。
开发对新媒体类型或格式的支持的人员应使用此接口。 写入媒体通常包括以下步骤：
- 通过设置媒体的模式页来准备硬件。
- 查询硬件以验证媒体是否足够大。
- 初始化写入，例如，通过设置媒体格式或设置 OPC。
- 执行实际的 WRITE 命令。
- 通过停止格式设置或关闭会话或轨道完成写入。
大多数客户端应用程序应使用 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 |