setTapeParameters 函式 (winbase.h)

SetTapeParameters函式會指定磁帶的區塊大小或設定磁帶裝置。

語法

DWORD SetTapeParameters(
  [in] HANDLE hDevice,
  [in] DWORD  dwOperation,
  [in] LPVOID lpTapeInformation
);

[in] hDevice

要設定組態資訊的裝置控制碼。此控制碼是使用 CreateFile 函式所建立。

[in] dwOperation

要設定的資訊類型。此參數必須是下列其中一個值。

值	意義
SET_TAPE_DRIVE_INFORMATION 1L	設定 lpTapeInformation所指定的裝置特定資訊。
SET_TAPE_MEDIA_INFORMATION 0L	設定 lpTapeInformation 參數所指定的磁帶特定資訊。

[in] lpTapeInformation

結構的指標，其中包含要設定的資訊。如果 dwOperation 參數是SET_TAPE_MEDIA_INFORMATION， lpTapeInformation 會指向 TAPE_SET_MEDIA_PARAMETERS 結構。

如果 dwOperation 是SET_TAPE_DRIVE_INFORMATION， lpTapeInformation 會指向 TAPE_SET_DRIVE_PARAMETERS 結構。

如果函式成功，傳回值會NO_ERROR。

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

錯誤	描述
ERROR_BEGINNING_OF_MEDIA 1102L	嘗試在中度開始標記失敗之前存取資料。
ERROR_BUS_RESET 1111L	在匯流排上偵測到重設條件。
ERROR_DEVICE_NOT_PARTITIONED 1107L	載入磁帶時找不到資料分割資訊。
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	媒體受到寫入保護。