IDiscRecorder2::InitializeDiscRecorder 方法 (imapi2.h)
將物件與指定的光碟裝置產生關聯。
語法
HRESULT InitializeDiscRecorder(
[in] BSTR recorderUniqueId
);
參數
[in] recorderUniqueId
包含裝置唯一識別碼的字串。
傳回值
S_OK會在成功時傳回,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:
傳回碼 | Description |
---|---|
|
一或多個自變數無效。
值:0x80070057 |
|
cchDest 中的值是 0 或大於 STRSAFE_MAX_CCH。 |
|
未指定的失敗。
值:0x80004005 |
|
無法配置所需的記憶體。
值:0x8007000E |
|
裝置無法在逾時期間內接受命令。 這可能是因為裝置進入不一致的狀態而造成,或者可能需要增加命令的逾時值。
值:0xC0AA020D |
|
裝置回報命令的非預期或無效數據。
值:0xC0AA02FF |
|
媒體會向下插入。
值:0xC0AA0204 |
|
磁碟驅動器回報它正在準備好。 請稍後再試一次要求。
值:0xC0AA0205 |
|
裝置中沒有媒體。
值:0xC0AA0202 |
|
媒體目前正在格式化。 請先等候格式完成,再嘗試使用媒體。
值:0xC0AA0206 |
|
磁碟驅動器回報正在執行長時間執行的作業,例如完成寫入。 磁碟驅動器可能長時間無法使用。
值:0xC0AA0207 |
|
寫入失敗,因為磁碟驅動器未快速收到足以繼續寫入的數據。 將源數據移至本機計算機、減少寫入速度,或啟用 [緩衝區不足] 設定可能會解決此問題。
值:0xC0AA0300 |
|
媒體不相容或未知的實體格式。
值:0xC0AA0203 |
|
DVD 結構不存在。 這可能是因為使用的磁碟驅動器/媒體不相容所造成。
值:0xC0AA020E |
|
裝置回報要求的模式頁面 (,且類型) 不存在。
值:0xC0AA0201 |
|
磁碟驅動器報告不支援MODE SELECT 命令在模式頁面中提供的參數組合。
值:0xC0AA0208 |
|
磁碟驅動器回報媒體受到寫入保護。
值:0xC0AA0209 |
|
媒體的速度與裝置不相容。 這可能是因為使用比裝置支援的速度範圍還要高或較低的速度媒體所造成。
值:0xC0AA020F |
|
指定的句柄無效。
值:6 |
|
指定的網路資源或裝置已無法使用。
值:55 |
|
上次作業期間與此錄製器相關聯的裝置已獨佔鎖定,導致此作業失敗。
值:0xC0AA0210 |
備註
您必須先初始化錄製器,才能呼叫此介面的任何方法。
若要擷取電腦上的裝置清單及其唯一標識碼,請呼叫 IDiscMaster2::get__NewEnum 方法。
這個方法不會在獨佔鎖定的磁碟驅動器上失敗。 不過,如果磁碟驅動器是獨佔鎖定的,此介面的數種方法可能會傳回E_IMAPI_RECORDER_LOCKED。 若要判斷誰具有獨佔存取權,請呼叫 IDiscRecorder2::get_ExclusiveAccessOwner 方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | imapi2.h |