createTapePartition 函式 (winbase.h)

CreateTapePartition 函式會重新格式化磁帶。

語法

DWORD CreateTapePartition(
  [in] HANDLE hDevice,
  [in] DWORD  dwPartitionMethod,
  [in] DWORD  dwCount,
  [in] DWORD  dwSize
);

[in] hDevice

要建立新分割區的裝置句柄。此句柄是使用 CreateFile 函式所建立。

[in] dwPartitionMethod

要建立的數據分割類型。若要判斷裝置支援的分割區類型，請參閱硬體的檔。此參數可以有下列其中一個值。

值	意義
TAPE_FIXED_PARTITIONS 0L	根據裝置的預設分割區定義來分割磁帶。會忽略 dwCount 和 dwSize 參數。
TAPE_INITIATOR_PARTITIONS 2L	將磁帶分割成 dwCount 和 dwSize 所指定的分割區數目和大小，但最後一個數據分割除外。最後一個分割區的大小是磁帶的其餘部分。
TAPE_SELECT_PARTITIONS 1L	將磁帶分割成 dwCount 所指定的分割區數目。會忽略 dwSize 參數。磁碟分區的大小取決於裝置的預設分割區大小。如需更具體的資訊，請參閱磁帶裝置的檔。

[in] dwCount

要建立的數據分割數目。 GetTapeParameters 函式提供磁帶可支援的最大分割區數目。

[in] dwSize

每個分割區的大小，以 MB 為單位。如果 dwPartitionMethod 參數 TAPE_SELECT_PARTITIONS，則會忽略此值。

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

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

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

建立分割區會將磁帶重新格式化。磁帶上記錄的所有先前信息都會終結。