IDiscFormat2TrackAtOnce：：SetWriteSpeed 方法 (imapi2.h)

项目
08/24/2023

设置光盘录制器的写入速度。

语法

HRESULT SetWriteSpeed(
  [in] LONG         RequestedSectorsPerSecond,
  [in] VARIANT_BOOL RotationTypeIsPureCAV
);

parameters

[in] RequestedSectorsPerSecond

请求的写入速度以光盘扇区/秒为单位。

0xFFFFFFFF (-1 的值) 请求使用媒体支持的最快速度进行写入。这是默认值。

[in] RotationTypeIsPureCAV

请求的旋转速度控制类型。设置为 VARIANT_TRUE， (CAV) 旋转速度控制类型请求恒定角速度。设置为 VARIANT_FALSE 以使用记录器支持的另一种旋转速度控件类型。默认值为 VARIANT_FALSE。

返回值

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

返回代码	说明
E_IMAPI_RECORDER_REQUIRED	该请求要求选择当前光盘记录器。值：0xC0AA0003
E_INVALIDARG	一个或多个参数无效。值：0x80070057
E_POINTER	指针无效。值：0x80004003
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_UNEXPECTED_RESPONSE_FROM_DEVICE	写入失败，因为驱动器返回了无法从中恢复的错误信息。值：0xC0AA0301
S_IMAPI_ROTATIONADJUSTED	驱动器不支持请求的旋转类型，旋转类型已调整。值：0x00AA0005
S_IMAPI_SPEEDADJUSTED	驱动器不支持请求的写入速度，并且速度已调整。值：0x00AA0004
S_IMAPI_BOTHADJUSTED	驱动器不支持请求的写入速度和旋转类型，它们都已调整。值：0x00AA0006

注解

此方法设置记录器的写入速度和旋转速度控件的类型。请求的值可能与记录器中设置的值不同。若要指定记录器，请调用 IDiscFormat2TrackAtOnce：:p ut_Recorder 方法。

如果记录器支持请求的写入速度，则光盘设备将使用请求的值。如果记录器不支持请求的写入速度，则记录器将使用它支持的最接近请求值的写入速度。 IDiscFormat2TrackAtOnce：：get_CurrentWriteSpeed 属性包含记录器使用的值。

若要检索记录器和当前媒体支持的写入速度列表，请调用 IDiscFormat2TrackAtOnce：：get_SupportedWriteSpeeds 方法。

如果为旋转速度控制类型请求固定角速度 (CAV) ，并且记录器不支持 CAV，光盘设备将使用它支持的另一种旋转速度控制类型。 IDiscFormat2TrackAtOnce：：get_CurrentRotationTypeIsPureCAV 属性指示记录器使用的值。

若要检索请求的值，请调用 IDiscFormat2TrackAtOnce：：get_RequestedWriteSpeed 和 IDiscFormat2TrackAtOnce：：get_RequestedRotationTypeIsPureCAV 方法。

要求


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