共用方式為


IDiscRecorder2Ex::GetTrackInformation 方法 (imapi2.h)

從媒體擷取追蹤資訊。

語法

HRESULT GetTrackInformation(
  [in]  ULONG                          address,
  [in]  IMAPI_READ_TRACK_ADDRESS_TYPE  addressType,
  [out] BYTE                           **trackInformation,
  [out] ULONG_IMAPI2_TRACK_INFORMATION *byteSize
);

參數

[in] address

[位址] 欄位。 addressType參數會提供此參數的其他內容。

[in] addressType

例如,如果這是 LBA 位址或追蹤號碼,則位址參數中指定的 位址 類型。 如需可能的值,請參閱 IMAPI_READ_TRACK_ADDRESS_TYPE 列舉類型。

[out] trackInformation

包含追蹤資訊的資料緩衝區。 如需資料緩衝區內容的詳細資料,請參閱 FTP://FTP.T10.ORG/T10/DRAFTS/MMC5之 MMC 規格最新修訂中的 READ TRACK INFORMATION 命令。

完成時,呼叫 CoTaskMemFree 函式以釋放記憶體。

[out] byteSize

trackInformation資料緩衝區的大小,以位元組為單位。

傳回值

S_OK會在成功時傳回,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 描述
E_POINTER
指標無效。

值:0x80004003

E_FAIL
未指定的失敗。

值:0x80004005

E_IMAPI_RECORDER_GET_CONFIGURATION_NOT_SUPPORTED
磁片磁碟機不支援 GET CONFIGURATION 命令。

值:0xC0AA020C

E_IMAPI_RECORDER_NO_SUCH_FEATURE
裝置不支援所要求的功能頁面。

值:0xC0AA020A

E_OUTOFMEMORY
無法配置所需的記憶體。

值:0x8007000E

E_IMAPI_RECORDER_FEATURE_IS_NOT_CURRENT
支援要求的功能頁面,但未標示為目前。

值:0xC0AA020B

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

需求

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

另請參閱

IDiscRecorder2Ex