| 术语 | writetapemark |
| 释义 | WriteTapemark 语法： C++ DWORD WriteTapemark( __in HANDLE hDevice, __in DWORD dwTapemarkType, __in DWORD dwTapemarkCount, __in BOOL bImmediate ); WriteTapemark功能 该WriteTapemark函数写了一个filemarks，setmarks，短filemarks，或长期filemarks指定数目的磁带设备。这些tapemarks划分为更小的地区磁带分区。 参数 hDevice [in] 设备句柄上写tapemarks。这种处理是通过使用CreateFile函数创建。 dwTapemarkType [in] tapemarks类型的编写。此参数可以是下列值之一。 ValueMeaning TAPE_FILEMARKS 1LWrites了由dwTapemarkCount参数指定filemarks数目。 TAPE_LONG_FILEMARKS 3LWrites由dwTapemarkCount指定的长期filemarks数目。 TAPE_SETMARKS 0LWrites由dwTapemarkCount指定setmarks数目。 TAPE_SHORT_FILEMARKS 2LWrites由dwTapemarkCount指定的短filemarks数目。 dwTapemarkCount [in] 数的tapemarks写。 bImmediate [in] 如果此参数为TRUE，函数立即返回，如果是FALSE，则函数不返回，直到操作已经完成。 返回值 如果函数成功，返回值为NO_ERROR。 如果函数失败，它可以返回以下错误代码之一。 ErrorDescription ERROR_BEGINNING_OF_MEDIA 1102LAn试图访问数据之前开始的介质标记失败。 ERROR_BUS_RESET 1111LA复位条件检测总线上。 ERROR_DEVICE_NOT_PARTITIONED 1107LThe分区信息时，找不到磁带被加载。 ERROR_END_OF_MEDIA 1100LThe最终磁带标记达成了一项行动。 ERROR_FILEMARK_DETECTED 1101LA文件标记达成了一项行动。 ERROR_INVALID_BLOCK_LENGTH 1106LThe块大小不正确的，是在一个多卷分区的新磁带。 ERROR_MEDIA_CHANGED 1110LThe磁带，在驱动器已被替换或删除。 ERROR_NO_DATA_DETECTED 1104LThe终了数据标记达成了一项行动。 ERROR_NO_MEDIA_IN_DRIVE 1112LThere在驱动器中没有媒体。 ERROR_NOT_SUPPORTED 50LThe磁带驱动程序不支持请求的功能。 ERROR_PARTITION_FAILURE 1105LThe磁带不能分区。 ERROR_SETMARK_DETECTED 1103LA setmark达成了一项行动。 ERROR_UNABLE_TO_LOCK_MEDIA 1108LAn试图锁定弹射机制的失败。 ERROR_UNABLE_TO_UNLOAD_MEDIA 1109LAn尝试卸载磁带失败。 ERROR_WRITE_PROTECT 19LThe媒体是写保护。 备注 Filemarks，setmarks，短filemarks，长期filemarks记录的特殊因素，说明该磁带的线性组织。这些商标没有包含用户数据。 Filemarks是最一般的标志; setmarks提供了一个层次不filemarks可用。 简短的文件标记包含一个简短消除差距，不能被覆盖，除非写操作是从分区或从早期的长文件标记开始执行。 阿长文件标记包含一个长消除差距，允许应用程序定位在文件标记开始，并覆盖文件标记和消除差距的磁带。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderWinbase.h(头文件：winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 CreateFile 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝WriteTapemark Function The WriteTapemark function writes a specified number of filemarks, setmarks, short filemarks, or long filemarks to a tape device. These tapemarks divide a tape partition into smaller areas. Syntax C++ DWORD WriteTapemark( __in HANDLE hDevice, __in DWORD dwTapemarkType, __in DWORD dwTapemarkCount, __in BOOL bImmediate ); Parameters hDevice [in] Handle to the device on which to write tapemarks. This handle is created by using the CreateFile function. dwTapemarkType [in] Type of tapemarks to write. This parameter can be one of the following values. ValueMeaning TAPE_FILEMARKS 1LWrites the number of filemarks specified by the dwTapemarkCount parameter. TAPE_LONG_FILEMARKS 3LWrites the number of long filemarks specified by dwTapemarkCount. TAPE_SETMARKS 0LWrites the number of setmarks specified by dwTapemarkCount. TAPE_SHORT_FILEMARKS 2LWrites the number of short filemarks specified by dwTapemarkCount. dwTapemarkCount [in] Number of tapemarks to write. bImmediate [in] If this parameter is TRUE, the function returns immediately; if it is FALSE, the function does not return until the operation has been completed. 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_DEVICE_NOT_PARTITIONED 1107LThe partition information could not be found when a tape was being loaded. 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_INVALID_BLOCK_LENGTH 1106LThe block size is incorrect on a new tape in a multivolume partition. ERROR_MEDIA_CHANGED 1110LThe tape that was in the drive has been replaced or removed. ERROR_NO_DATA_DETECTED 1104LThe end-of-data marker was reached during an operation. 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_PARTITION_FAILURE 1105LThe tape could not be partitioned. ERROR_SETMARK_DETECTED 1103LA setmark was reached during an operation. 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 Filemarks, setmarks, short filemarks, and long filemarks are special recorded elements that denote the linear organization of the tape. None of these marks contain user data. Filemarks are the most general marks; setmarks provide a hierarchy not available with filemarks. A short filemark contains a short erase gap that cannot be overwritten unless the write operation is performed from the beginning of the partition or from an earlier long filemark. A long filemark contains a long erase gap that allows an application to position the tape at the beginning of the filemark and to overwrite the filemark and the erase gap. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also CreateFile Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa362668(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。