IDiscFormat2RawCD：：SetWriteSpeed 方法 (imapi2.h)

發行項
03/14/2023

設定光碟錄製器的寫入速度。

語法

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

參數

[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_DF2RAW_MEDIA_IS_NOT_SUPPORTED	僅支援空白 CD-R/RW 媒體。值：0xC0AA0606
E_IMAPI_DF2RAW_MEDIA_IS_NOT_BLANK	僅支援空白 CD-R/RW 媒體。值：0xC0AA0607
E_IMAPI_DF2RAW_CLIENT_NAME_IS_NOT_VALID	用戶端名稱無效。值：0xC0AA0604
S_IMAPI_ROTATIONADJUSTED	磁片磁碟機不支援要求的旋轉類型，而且已調整旋轉類型。值：0x00AA0005
S_IMAPI_SPEEDADJUSTED	磁片磁碟機不支援要求的寫入速度，而且速度已調整。值：0x00AA0004
S_IMAPI_BOTHADJUSTED	磁片磁碟機不支援要求的寫入速度和旋轉類型，而且兩者都已調整。值：0x00AA0006

備註

這個方法會設定錄製器之旋轉速度控制項的寫入速度和類型。要求的值可能與錄製器中設定的值不同。若要指定錄製器，請呼叫 IDiscFormat2RawCD：:p ut_Recorder 方法。

如果錄製器支援要求的寫入速度，磁片裝置會使用所要求的值。如果錄製器不支援要求的寫入速度，錄製器會使用它支援最接近所要求值的寫入速度。 IDiscFormat2RawCD：：get_CurrentWriteSpeed屬性包含錄製器所使用的值。

若要擷取錄製器和目前媒體支援的寫入速度清單，請呼叫 IDiscFormat2RawCD：：get_SupportedWriteSpeeds 方法。

如果您針對旋轉速度控制類型要求固定角度速度 (CAV) ，而且錄製器不支援 CAV，則磁片裝置會使用它支援的另一種旋轉速度控制類型。 IDiscFormat2RawCD：：get_CurrentRotationTypeIsPureCAV屬性工作表示錄製器所使用的值。

若要擷取要求的值，請呼叫 IDiscFormat2RawCD：：get_RequestedWriteSpeed 和 IDiscFormat2RawCD：：get_RequestedRotationTypeIsPureCAV 方法。

需求


最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	imapi2.h