术语 | createtapepartition |
释义 | CreateTapePartition 语法: C++ DWORD CreateTapePartition( __in HANDLE hDevice, __in DWORD dwPartitionMethod, __in DWORD dwCount, __in DWORD dwSize ); CreateTapePartition功能 该CreateTapePartition函数格式化磁带。 参数 hDevice [in] Handle to the device where the new partition is to be created.这种处理是通过使用CreateFile函数创建。 dwPartitionMethod [in] 分区的类型来创建。要确定您的设备支持的分区类型,请参阅您的硬件文档。此参数可以有以下值之一。 ValueMeaning TAPE_FIXED_PARTITIONS 0LPartitions的基于设备的默认的分区定义磁带。在dwCount和dwSize参数将被忽略。 TAPE_INITIATOR_PARTITIONS 2LPartitions到磁带的数量和指定的分区的大小dwCount和dwSize,分别,除了最后一个分区。最后一个分区的大小是磁带的其余部分。 TAPE_SELECT_PARTITIONS 1LPartitions到由dwCount指定的分区数目磁带。该dwSize参数被忽略。该分区的大小取决于该设备的默认分区大小。有关更具体的信息,请参阅您的磁带设备文档。 dwCount [in] 分区的数量创建。该GetTapeParameters功能分区提供了磁带可以支持的最大数目。 dwSize [in] 每个分区的大小,以兆字节。此值将被忽略,如果dwPartitionMethod参数TAPE_SELECT_PARTITIONS。 返回值 如果函数成功,返回值为NO_ERROR。 如果函数失败,它可以返回以下错误代码之一。 ErrorDescription ERROR_BEGINNING_OF_MEDIA 1102LAn试图访问数据之前开始的介质标记失败。 ERROR_BUS_RESET 1111LA复位条件检测总线上。 ERROR_END_OF_MEDIA 1100LThe最终磁带标记达成了一项行动。 ERROR_FILEMARK_DETECTED 1101LA文件标记达成了一项行动。 ERROR_SETMARK_DETECTED 1103LA setmark达成了一项行动。 ERROR_NO_DATA_DETECTED 1104LThe终了数据标记达成了一项行动。 ERROR_PARTITION_FAILURE 1105LThe磁带不能分区。 ERROR_INVALID_BLOCK_LENGTH 1106LThe块大小不正确的,是在一个多卷分区的新磁带。 ERROR_DEVICE_NOT_PARTITIONED 1107LThe分区信息时,找不到磁带被加载。 ERROR_MEDIA_CHANGED 1110LThe磁带,在驱动器已被替换或删除。 ERROR_NO_MEDIA_IN_DRIVE 1112LThere在驱动器中没有媒体。 ERROR_NOT_SUPPORTED 50LThe磁带驱动程序不支持请求的功能。 ERROR_UNABLE_TO_LOCK_MEDIA 1108LAn试图锁定弹射机制的失败。 ERROR_UNABLE_TO_UNLOAD_MEDIA 1109LAn尝试卸载磁带失败。 ERROR_WRITE_PROTECT 19LThe媒体是写保护。 备注 创建分区格式化磁带。所有以前的信息记录在磁带上被销毁。 要求: 最低支持:client-Windows 2000专业版 最低支持server-Windows 2000服务器 HeaderWinbase.h(头文件:winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 CreateFile GetTapeParameters 如果有任何问题和意见,请发送给微软(wsddocfb@microsoft.com) 生成日期:2009年7月30日 ==英文原文==CreateTapePartition Function The CreateTapePartition function reformats a tape. Syntax C++ DWORD CreateTapePartition( __in HANDLE hDevice, __in DWORD dwPartitionMethod, __in DWORD dwCount, __in DWORD dwSize ); Parameters hDevice [in] Handle to the device where the new partition is to be created. This handle is created by using the CreateFile function. dwPartitionMethod [in] Type of partition to create. To determine what type of partitions your device supports, see the documentation for your hardware. This parameter can have one of the following values. ValueMeaning TAPE_FIXED_PARTITIONS 0LPartitions the tape based on the device's default definition of partitions. The dwCount and dwSize parameters are ignored. TAPE_INITIATOR_PARTITIONS 2LPartitions the tape into the number and size of partitions specified by dwCount and dwSize, respectively, except for the last partition. The size of the last partition is the remainder of the tape. TAPE_SELECT_PARTITIONS 1LPartitions the tape into the number of partitions specified by dwCount. The dwSize parameter is ignored. The size of the partitions is determined by the device's default partition size. For more specific information, see the documentation for your tape device. dwCount [in] Number of partitions to create. The GetTapeParameters function provides the maximum number of partitions a tape can support. dwSize [in] Size of each partition, in megabytes. This value is ignored if the dwPartitionMethod parameter is TAPE_SELECT_PARTITIONS. Return Value If the function succeeds, the return value is NO_ERROR. If the function fails, it can return one of the following error codes. ErrorDescription ERROR_BEGINNING_OF_MEDIA 1102LAn attempt to access data before the beginning-of-medium marker failed. ERROR_BUS_RESET 1111LA reset condition was detected on the bus. ERROR_END_OF_MEDIA 1100LThe end-of-tape marker was reached during an operation. ERROR_FILEMARK_DETECTED 1101LA filemark was reached during an operation. ERROR_SETMARK_DETECTED 1103LA setmark was reached during an operation. ERROR_NO_DATA_DETECTED 1104LThe end-of-data marker was reached during an operation. ERROR_PARTITION_FAILURE 1105LThe tape could not be partitioned. ERROR_INVALID_BLOCK_LENGTH 1106LThe block size is incorrect on a new tape in a multivolume partition. ERROR_DEVICE_NOT_PARTITIONED 1107LThe partition information could not be found when a tape was being loaded. ERROR_MEDIA_CHANGED 1110LThe tape that was in the drive has been replaced or removed. ERROR_NO_MEDIA_IN_DRIVE 1112LThere is no media in the drive. ERROR_NOT_SUPPORTED 50LThe tape driver does not support a requested function. ERROR_UNABLE_TO_LOCK_MEDIA 1108LAn attempt to lock the ejection mechanism failed. ERROR_UNABLE_TO_UNLOAD_MEDIA 1109LAn attempt to unload the tape failed. ERROR_WRITE_PROTECT 19LThe media is write protected. Remarks Creating partitions reformats the tape. All previous information recorded on the tape is destroyed. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also CreateFile GetTapeParameters Send comments about this topic to Microsoft Build date: 7/30/2009 ==原始网址==http://msdn.microsoft.com/en-us/library/aa362519(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。