Структура 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, то включена функция создания отчетов по метки. В противном случае он будет отключен.
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
|
Устройство перемещает ленту назад по блокам, меткам файлов или меткам setmark.
|
-
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