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。

如果函数失败，可能会返回以下错误代码之一。

错误	说明
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	介质受写入保护。

创建分区会重新格式化磁带。磁带上记录的所有先前信息都会被销毁。