IDiscFormat2Data::SetWriteSpeed 方法 (imapi2.h)

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

语法

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

注解

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

如果记录器支持请求的写入速度,则光盘设备将使用请求的值。 如果记录器不支持请求的写入速度,则记录器将使用它确实支持的写入速度,该速度最接近请求的值。 IDiscFormat2Data::get_CurrentWriteSpeed 属性包含记录器使用的值。

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

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

若要检索请求的值,请调用 IDiscFormat2Data::get_RequestedWriteSpeedIDiscFormat2Data::get_RequestedRotationTypeIsPureCAV 方法。

要求

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

另请参阅

IDiscFormat2Data

IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV

IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV

IDiscFormat2Data::get_SupportedWriteSpeedDescriptors

IDiscFormat2Data::get_SupportedWriteSpeeds