TAPE_GET_DRIVE_PARAMETERS 结构 (winnt.h)

项目
08/27/2023

TAPE_GET_DRIVE_PARAMETERS结构描述磁带驱动器。它由 GetTapeParameters 函数使用。

语法

typedef struct _TAPE_GET_DRIVE_PARAMETERS {
  BOOLEAN ECC;
  BOOLEAN Compression;
  BOOLEAN DataPadding;
  BOOLEAN ReportSetmarks;
  DWORD   DefaultBlockSize;
  DWORD   MaximumBlockSize;
  DWORD   MinimumBlockSize;
  DWORD   MaximumPartitionCount;
  DWORD   FeaturesLow;
  DWORD   FeaturesHigh;
  DWORD   EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;

成员

ECC

如果此成员为 TRUE，则设备支持硬件纠错。否则，它不具有该属性。

Compression

如果此成员为 TRUE，则启用硬件数据压缩。否则，将禁用它。

DataPadding

如果此成员为 TRUE，则启用数据填充。否则，将禁用它。数据填充使磁带流式处理保持恒定的速度。

ReportSetmarks

如果此成员为 TRUE，则启用 setmark 报告。否则，将禁用它。

DefaultBlockSize

设备的默认固定块大小（以字节为单位）。

MaximumBlockSize

设备的最大块大小（以字节为单位）。

MinimumBlockSize

设备的最小块大小（以字节为单位）。

MaximumPartitionCount

可在设备上创建的最大分区数。

FeaturesLow

设备功能标志的低序位。此成员可以是以下一个或多个值。

值	含义
TAPE_DRIVE_COMPRESSION 0x00020000	设备支持硬件数据压缩。
TAPE_DRIVE_CLEAN_REQUESTS 0x02000000	设备可以报告是否需要清洁。
TAPE_DRIVE_ECC 0x00010000	设备支持硬件错误更正。
TAPE_DRIVE_EJECT_MEDIA 0x01000000	设备在软件弹出时以物理方式弹出磁带。
TAPE_DRIVE_ERASE_BOP_ONLY 0x00000040	设备仅从分区开头标记执行擦除操作。
TAPE_DRIVE_ERASE_LONG 0x00000020	设备执行长时间擦除操作。
TAPE_DRIVE_ERASE_IMMEDIATE 0x00000080	设备会立即执行擦除操作，即在擦除操作开始时返回。
TAPE_DRIVE_ERASE_SHORT 0x00000010	设备执行短时间擦除操作。
TAPE_DRIVE_FIXED 0x00000001	设备创建固定数据分区。
TAPE_DRIVE_FIXED_BLOCK 0x00000400	设备支持固定长度块模式。
TAPE_DRIVE_GET_ABSOLUTE_BLK 0x00100000	设备提供当前特定于设备的块地址。
TAPE_DRIVE_GET_LOGICAL_BLK 0x00200000	设备提供当前逻辑块地址 (和逻辑磁带分区) 。
TAPE_DRIVE_INITIATOR 0x00000004	设备创建发起程序定义的分区。
TAPE_DRIVE_PADDING 0x00040000	设备支持数据填充。
TAPE_DRIVE_REPORT_SMKS 0x00080000	设备支持设置标记报告。
TAPE_DRIVE_SELECT 0x00000002	设备创建选择数据分区。
TAPE_DRIVE_SET_CMP_BOP_ONLY 0x04000000	设备必须位于分区的开头，然后才能设置压缩。
TAPE_DRIVE_SET_EOT_WZ_SIZE 0x00400000	设备支持设置中端警告大小。
TAPE_DRIVE_TAPE_CAPACITY 0x00000100	设备返回磁带的最大容量。
TAPE_DRIVE_TAPE_REMAINING 0x00000200	设备返回磁带的剩余容量。
TAPE_DRIVE_VARIABLE_BLOCK 0x00000800	设备支持可变长度块模式。
TAPE_DRIVE_WRITE_PROTECT 0x00001000	如果磁带已启用写入或受写保护，则设备将返回错误。

FeaturesHigh

设备功能标志的高阶位。此成员可以是以下一个或多个值。

值	含义
TAPE_DRIVE_ABS_BLK_IMMED 0x80002000	设备将磁带移动到特定于设备的块地址，并在移动开始后立即返回。
TAPE_DRIVE_ABSOLUTE_BLK 0x80001000	设备将磁带移动到设备特定的块地址。
TAPE_DRIVE_END_OF_DATA 0x80010000	设备将磁带移动到分区中的数据结束标记。
TAPE_DRIVE_FILEMARKS 0x80040000	设备将磁带向前移动 (或向后移动) 指定数量的文件标记。
TAPE_DRIVE_LOAD_UNLOAD 0x80000001	设备启用和禁用设备以执行进一步操作。
TAPE_DRIVE_LOAD_UNLD_IMMED 0x80000020	设备支持立即加载和卸载操作。
TAPE_DRIVE_LOCK_UNLOCK 0x80000004	设备启用和禁用磁带弹出机制。
TAPE_DRIVE_LOCK_UNLK_IMMED 0x80000080	设备支持立即锁定和解锁操作。
TAPE_DRIVE_LOG_BLK_IMMED 0x80008000	设备将磁带移动到分区中的逻辑块地址，并在移动开始后立即返回。
TAPE_DRIVE_LOGICAL_BLK 0x80004000	设备将磁带移动到分区中的逻辑块地址。
TAPE_DRIVE_RELATIVE_BLKS 0x80020000	设备将磁带向前移动 (或向后移动) 指定数量的块。
TAPE_DRIVE_REVERSE_POSITION 0x80400000	设备将磁带向后移动到块、文件标记或设置标记上。
TAPE_DRIVE_REWIND_IMMEDIATE 0x80000008	设备支持立即倒带操作。
TAPE_DRIVE_SEQUENTIAL_FMKS 0x80080000	设备将磁带向前移动 (或向后移动) 到指定数量的连续文件标记的第一次出现。
TAPE_DRIVE_SEQUENTIAL_SMKS 0x80200000	设备将磁带向前移动 (或向后移动) 到指定数量的连续设置标记的第一次出现。
TAPE_DRIVE_SET_BLOCK_SIZE 0x80000010	设备支持设置固定长度逻辑块的大小或设置可变长度块模式。
TAPE_DRIVE_SET_COMPRESSION 0x80000200	设备启用和禁用硬件数据压缩。
TAPE_DRIVE_SET_ECC 0x80000100	设备启用和禁用硬件错误更正。
TAPE_DRIVE_SET_PADDING 0x80000400	设备启用和禁用数据填充。
TAPE_DRIVE_SET_REPORT_SMKS 0x80000800	设备启用和禁用设置标记的报告。
TAPE_DRIVE_SETMARKS 0x80100000	设备将磁带向前移动 (或反向移动) 指定数量的设置标记。
TAPE_DRIVE_SPACE_IMMEDIATE 0x80800000	设备支持即时间距。
TAPE_DRIVE_TENSION 0x80000002	设备支持磁带张紧。
TAPE_DRIVE_TENSION_IMMED 0x80000040	该设备支持立即胶带张紧。
TAPE_DRIVE_WRITE_FILEMARKS 0x82000000	设备写入文件标记。
TAPE_DRIVE_WRITE_LONG_FMKS 0x88000000	设备写入长文件标记。
TAPE_DRIVE_WRITE_MARK_IMMED 0x90000000	设备支持立即写入短文件标记和长文件标记。
TAPE_DRIVE_WRITE_SETMARKS 0x81000000	设备写入设置标记。
TAPE_DRIVE_WRITE_SHORT_FMKS 0x84000000	设备写入短文件标记。

EOTWarningZoneSize

指示磁带端警告与磁带物理端之间的字节数。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	winnt.h (包括 Windows.h)

另请参阅

GetTapeParameters

通过

TAPE_GET_DRIVE_PARAMETERS 结构 (winnt.h)

语法

成员

要求

另请参阅

反馈

其他资源