CreateTapePartition功能重新格式化磁带。
DWORD CreateTapePartition(
HANDLE 【hDevice】, | //打开设备的句柄 |
DWORD 【dwPartitionMethod】, | //新建分区类型 |
DWORD 【dwCount】, | //要创建的新分区数 |
DWORD 【的dwSize】 | //新分区的大小,以兆字节为单位 |
); |
参数
【hDevice】
标识要创建新分区的设备。该句柄是通过使用CreateFile函数创建的。
【dwPartitionMethod】
指定要创建的分区类型。要确定您的设备支持什么类型的分区,请参阅硬件的文档。此参数可以具有以下值之一:
值 | 描述 |
TAPE_FIXED_PARTITIONS | 根据设备的分区默认定义对磁带进行分区。【dwCount】和【的dwSize】参数将被忽略。 |
TAPE_INITIATOR_PARTITIONS | 将磁带划分为【dwCount】和【的dwSize】指定的分区的数量和大小,但最后一个分区除外。最后一个分区的大小是磁带的其余部分。 |
TAPE_SELECT_PARTITIONS | 将磁带分区为【dwCount】指定的分区数。【的dwSize】参数被忽略。分区的大小由设备的默认分区大小决定。有关更多具体信息,请参阅磁带设备的文档。 |
【dwCount】
指定要创建的分区数。GetTapeParameters功能提供磁带可支持的最大分区数。
【的dwSize】
指定每个分区的大小(以兆字节为单位)。如果【dwPartitionMethod】参数为TAPE_SELECT_PARTITIONS,则忽略此值。
返回值
如果函数成功,返回值为NO_ERROR。
如果该函数失败,它可能会返回以下错误代码之一:
错误 | 描述 |
ERROR_BEGINNING_OF_MEDIA | 在中间标记开始之前访问数据的尝试失败。 |
ERROR_BUS_RESET | 在总线上检测到复位条件。 |
ERROR_END_OF_MEDIA | 在操作期间到达磁带末端标记。 |
ERROR_FILEMARK_DETECTED | 在操作期间达到文件标记。 |
ERROR_SETMARK_DETECTED | 在操作期间达成了一个标记。 |
ERROR_NO_DATA_DETECTED | 在操作期间达到数据结尾标记。 |
ERROR_PARTITION_FAILURE | 磁带无法分区。 |
ERROR_INVALID_BLOCK_LENGTH | 多卷分区中的新磁带上的块大小不正确。 |
ERROR_DEVICE_NOT_PARTITIONED | 加载磁带时无法找到分区信息。 |
ERROR_MEDIA_CHANGED | 驱动器中的磁带已被更换或删除。 |
ERROR_NO_MEDIA_IN_DRIVE | 驱动器中没有媒体。 |
ERROR_NOT_SUPPORTED | 磁带驱动程序不支持所请求的功能。 |
ERROR_UNABLE_TO_LOCK_MEDIA | 试图锁定弹出机构失败。 |
ERROR_UNABLE_TO_UNLOAD_MEDIA | 尝试卸载磁带失败。 |
ERROR_WRITE_PROTECT | 媒体是写保护的。 |
备注
创建分区重新格式化磁带。磁带上记录的所有以前的信息都将被破坏。
也可以看看