GetTapeStatus 函式 (winbase.h)

GetTapeStatus 函式會判斷磁帶裝置是否準備好處理磁帶命令。

語法

DWORD GetTapeStatus(
  [in] HANDLE hDevice
);

[in] hDevice

要取得裝置狀態的裝置句柄。此句柄是使用 CreateFile 函式所建立。

如果磁帶裝置準備好接受適當的磁帶存取命令而不傳回錯誤，則會NO_ERROR傳回值。

如果函式失敗，它可以傳回下列其中一個錯誤碼。

錯誤碼	描述
ERROR_BEGINNING_OF_MEDIA 1102L	嘗試在媒體開頭標記失敗之前存取數據。
ERROR_BUS_RESET 1111L	在總線上偵測到重設條件。
ERROR_DEVICE_NOT_PARTITIONED 1107L	載入磁帶時，找不到分割區資訊。
ERROR_DEVICE_REQUIRES_CLEANING 1165L	磁帶機能夠報告它需要清除，並報告它確實需要清除。
ERROR_END_OF_MEDIA 1100L	作業期間已到達磁帶結尾標記。
ERROR_FILEMARK_DETECTED 1101L	作業期間已達到檔案標記。
ERROR_INVALID_BLOCK_LENGTH 1106L	多卷分割區中新磁帶上的區塊大小不正確。
ERROR_MEDIA_CHANGED 1110L	磁碟驅動器中的磁帶已取代或移除。
ERROR_NO_DATA_DETECTED 1104L	作業期間已達到數據結束標記。
ERROR_NO_MEDIA_IN_DRIVE 1112L	磁碟驅動器中沒有媒體。
ERROR_NOT_SUPPORTED 50L	磁帶驅動程式不支援要求的函式。
ERROR_PARTITION_FAILURE 1105L	無法分割磁帶。
ERROR_SETMARK_DETECTED 1103L	作業期間已達到 setmark。
ERROR_UNABLE_TO_LOCK_MEDIA 1108L	嘗試鎖定退出機制失敗。
ERROR_UNABLE_TO_UNLOAD_MEDIA 1109L	嘗試卸除磁帶失敗。
ERROR_WRITE_PROTECT 19L	媒體受到寫入保護。