IDiscFormat2RawCD：：WriteMedia 方法 (imapi2.h)

使用 MSF 95：00：00 作为起始地址将 DAO-96 原始图像写入空白媒体。

语法

HRESULT WriteMedia(
  [in] IStream *data
);

parameters

[in] data

要写入的数据流的 IStream 接口。

返回值

成功后返回S_OK，但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回，但不表示唯一可能的错误值：

返回代码	说明
E_POINTER	指针无效。 值：0x80004003
E_IMAPI_DF2RAW_STREAM_NOT_SUPPORTED	提供的音频流无效。 值：0xC0AA060D
E_IMAPI_DF2RAW_MEDIA_IS_NOT_PREPARED	仅当媒体已“准备好”时，请求的操作才有效。 值：0xC0AA0602
E_IMAPI_DF2RAW_WRITE_IN_PROGRESS	当前正在进行写入操作。 值：0xC0AA0600
E_IMAPI_DF2RAW_MEDIA_IS_NOT_BLANK	仅支持空白 CD-R/RW 介质。 值：0xC0AA0606
E_IMAPI_DF2RAW_STREAM_LEADIN_TOO_SHORT	对于当前媒体，该流在前导中不包含足够数量的扇区。 值：0xC0AA060F
E_INVALIDARG	一个或多个参数无效。 值：0x80070057
E_IMAPI_DF2RAW_NOT_ENOUGH_SPACE	媒体上没有足够的空间来添加提供的会话。 值：0xC0AA0609
E_FAIL	未知故障。 值：0x80004005
E_OUTOFMEMORY	未能分配所需的内存。 值：0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	设备未能在超时期限内接受该命令。 这可能是由于设备进入了不一致状态，或者可能需要增加命令的超时值。 值：0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	设备报告了命令的意外或无效数据。 值：0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	媒体是倒置插入的。 值：0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	驱动器报告它正在准备就绪。 请稍后重试请求。 值：0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	设备中没有媒体。 值：0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	媒体当前正在格式化。 请在尝试使用媒体之前等待格式完成。 值：0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	驱动器报告它正在执行长时间运行的操作，例如完成写入。 驱动器可能长时间不可用。 值：0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	写入失败，因为驱动器接收数据的速度不够快，无法继续写入。 将源数据移动到本地计算机、降低写入速度或启用“缓冲区不足可用”设置可以解决此问题。 值：0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	媒体不兼容或物理格式未知。 值：0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 结构不存在。 这可能是由于使用的驱动器/介质不兼容导致的。 值：0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	设备报告请求的模式页 (，并且不存在类型) 。 值：0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	驱动器报告不支持 MODE SELECT 命令的模式页中提供的参数组合。 值：0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	驱动器报告介质受到写入保护。 值：0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	媒体的速度与设备不兼容。 这可能是由于使用高于或低于设备支持的速度范围的媒体造成的。 值：0xC0AA020F
HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE)	指定的句柄无效。 值：6
HRESULT_FROM_WIN32 (ERROR_DEV_NOT_EXIST)	指定的网络资源或设备不再可用。 值：55
E_IMAPI_RECORDER_LOCKED	上次操作期间与此记录器关联的设备已被独占锁定，导致此操作失败。 值：0xC0AA0210
E_IMAPI_REQUEST_CANCELLED	请求已被取消。 值：0xC0AA0002

注解

在调用此方法之前，必须调用 IDiscFormat2RawCD：:p ut_Recorder 和 IDiscFormat2RawCD：:P repareMedia 方法。

如果方法的默认值不适用于应用程序，则还应考虑调用以下方法：

• IDiscFormat2RawCD：:p ut_BufferUnderrunFreeDisabled
• IDiscFormat2RawCD：:p ut_ClientName
• IDiscFormat2RawCD：:p ut_RequestedSectorType
• IDiscFormat2RawCD：：SetWriteSpeed

此方法是同步方法。 若要确定写入操作的进度，必须实现 DDiscFormat2RawCDEvents 接口。 有关演示如何在脚本中实现事件处理程序的示例，请参阅 使用事件监视进度。

原始映像的第一个扇区在 MSF 95：00：00 写入。 如果 RAW 映像具有不同的第一个扇区，请使用 IDiscFormat2RawCD：：WriteMedia2 方法。

此方法使用 IStream：：Seek 方法到达图像中当前媒体的相应起始位置。 如果 IStream：：Seek 方法失败，该方法将重复调用 IStream：：Read 方法，直到到达起始扇区。

DAO-96 标准允许将任何类型的数据写入 CD 介质。 一种常见用法是编写音频 CD，曲目之间没有 2 秒的间隔。

DAO-96 还支持子代码内容中的变体，例如 CD+G 和 CD-Text。

要求

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

另请参阅

IDiscFormat2RawCD

IDiscFormat2RawCD：：WriteMedia2