TAPE_GET_DRIVE_PARAMETERS structure (winnt.h)

The TAPE_GET_DRIVE_PARAMETERS structure describes the tape drive. It is used by the GetTapeParameters function.

Syntax

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;

Members

ECC

If this member is TRUE, the device supports hardware error correction. Otherwise, it does not.

Compression

If this member is TRUE, hardware data compression is enabled. Otherwise, it is disabled.

DataPadding

If this member is TRUE, data padding is enabled. Otherwise, it is disabled. Data padding keeps the tape streaming at a constant speed.

ReportSetmarks

If this member is TRUE, setmark reporting is enabled. Otherwise, it is disabled.

DefaultBlockSize

Device's default fixed block size, in bytes.

MaximumBlockSize

Device's maximum block size, in bytes.

MinimumBlockSize

Device's minimum block size, in bytes.

MaximumPartitionCount

Maximum number of partitions that can be created on the device.

FeaturesLow

Low-order bits of the device features flag. This member can be one or more of following values.

Value	Meaning
TAPE_DRIVE_COMPRESSION 0x00020000	The device supports hardware data compression.
TAPE_DRIVE_CLEAN_REQUESTS 0x02000000	The device can report if cleaning is required.
TAPE_DRIVE_ECC 0x00010000	The device supports hardware error correction.
TAPE_DRIVE_EJECT_MEDIA 0x01000000	The device physically ejects the tape on a software eject.
TAPE_DRIVE_ERASE_BOP_ONLY 0x00000040	The device performs the erase operation from the beginning-of-partition marker only.
TAPE_DRIVE_ERASE_LONG 0x00000020	The device performs a long erase operation.
TAPE_DRIVE_ERASE_IMMEDIATE 0x00000080	The device performs an immediate erase operation — that is, it returns when the erase operation begins.
TAPE_DRIVE_ERASE_SHORT 0x00000010	The device performs a short erase operation.
TAPE_DRIVE_FIXED 0x00000001	The device creates fixed data partitions.
TAPE_DRIVE_FIXED_BLOCK 0x00000400	The device supports fixed-length block mode.
TAPE_DRIVE_GET_ABSOLUTE_BLK 0x00100000	The device provides the current device-specific block address.
TAPE_DRIVE_GET_LOGICAL_BLK 0x00200000	The device provides the current logical block address (and logical tape partition).
TAPE_DRIVE_INITIATOR 0x00000004	The device creates initiator-defined partitions.
TAPE_DRIVE_PADDING 0x00040000	The device supports data padding.
TAPE_DRIVE_REPORT_SMKS 0x00080000	The device supports setmark reporting.
TAPE_DRIVE_SELECT 0x00000002	The device creates select data partitions.
TAPE_DRIVE_SET_CMP_BOP_ONLY 0x04000000	The device must be at the beginning of a partition before it can set compression on.
TAPE_DRIVE_SET_EOT_WZ_SIZE 0x00400000	The device supports setting the end-of-medium warning size.
TAPE_DRIVE_TAPE_CAPACITY 0x00000100	The device returns the maximum capacity of the tape.
TAPE_DRIVE_TAPE_REMAINING 0x00000200	The device returns the remaining capacity of the tape.
TAPE_DRIVE_VARIABLE_BLOCK 0x00000800	The device supports variable-length block mode.
TAPE_DRIVE_WRITE_PROTECT 0x00001000	The device returns an error if the tape is write-enabled or write-protected.

FeaturesHigh

High-order bits of the device features flag. This member can be one or more of the following values.

Value	Meaning
TAPE_DRIVE_ABS_BLK_IMMED 0x80002000	The device moves the tape to a device-specific block address and returns as soon as the move begins.
TAPE_DRIVE_ABSOLUTE_BLK 0x80001000	The device moves the tape to a device specific block address.
TAPE_DRIVE_END_OF_DATA 0x80010000	The device moves the tape to the end-of-data marker in a partition.
TAPE_DRIVE_FILEMARKS 0x80040000	The device moves the tape forward (or backward) a specified number of filemarks.
TAPE_DRIVE_LOAD_UNLOAD 0x80000001	The device enables and disables the device for further operations.
TAPE_DRIVE_LOAD_UNLD_IMMED 0x80000020	The device supports immediate load and unload operations.
TAPE_DRIVE_LOCK_UNLOCK 0x80000004	The device enables and disables the tape ejection mechanism.
TAPE_DRIVE_LOCK_UNLK_IMMED 0x80000080	The device supports immediate lock and unlock operations.
TAPE_DRIVE_LOG_BLK_IMMED 0x80008000	The device moves the tape to a logical block address in a partition and returns as soon as the move begins.
TAPE_DRIVE_LOGICAL_BLK 0x80004000	The device moves the tape to a logical block address in a partition.
TAPE_DRIVE_RELATIVE_BLKS 0x80020000	The device moves the tape forward (or backward) a specified number of blocks.
TAPE_DRIVE_REVERSE_POSITION 0x80400000	The device moves the tape backward over blocks, filemarks, or setmarks.
TAPE_DRIVE_REWIND_IMMEDIATE 0x80000008	The device supports immediate rewind operation.
TAPE_DRIVE_SEQUENTIAL_FMKS 0x80080000	The device moves the tape forward (or backward) to the first occurrence of a specified number of consecutive filemarks.
TAPE_DRIVE_SEQUENTIAL_SMKS 0x80200000	The device moves the tape forward (or backward) to the first occurrence of a specified number of consecutive setmarks.
TAPE_DRIVE_SET_BLOCK_SIZE 0x80000010	The device supports setting the size of a fixed-length logical block or setting the variable-length block mode.
TAPE_DRIVE_SET_COMPRESSION 0x80000200	The device enables and disables hardware data compression.
TAPE_DRIVE_SET_ECC 0x80000100	The device enables and disables hardware error correction.
TAPE_DRIVE_SET_PADDING 0x80000400	The device enables and disables data padding.
TAPE_DRIVE_SET_REPORT_SMKS 0x80000800	The device enables and disables the reporting of setmarks.
TAPE_DRIVE_SETMARKS 0x80100000	The device moves the tape forward (or reverse) a specified number of setmarks.
TAPE_DRIVE_SPACE_IMMEDIATE 0x80800000	The device supports immediate spacing.
TAPE_DRIVE_TENSION 0x80000002	The device supports tape tensioning.
TAPE_DRIVE_TENSION_IMMED 0x80000040	The device supports immediate tape tensioning.
TAPE_DRIVE_WRITE_FILEMARKS 0x82000000	The device writes filemarks.
TAPE_DRIVE_WRITE_LONG_FMKS 0x88000000	The device writes long filemarks.
TAPE_DRIVE_WRITE_MARK_IMMED 0x90000000	The device supports immediate writing of short and long filemarks.
TAPE_DRIVE_WRITE_SETMARKS 0x81000000	The device writes setmarks.
TAPE_DRIVE_WRITE_SHORT_FMKS 0x84000000	The device writes short filemarks.

EOTWarningZoneSize

Indicates the number of bytes between the end-of-tape warning and the physical end of the tape.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	winnt.h (include Windows.h)

See also

GetTapeParameters