TAPE_GET_DRIVE_PARAMETERS-Struktur (winnt.h)

Artikel
08/27/2023

Die TAPE_GET_DRIVE_PARAMETERS-Struktur beschreibt das Bandlaufwerk. Sie wird von der GetTapeParameters-Funktion verwendet.

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;

Member

ECC

Wenn dieser Member TRUE ist, unterstützt das Gerät die Hardwarefehlerkorrektur. Andernfalls trifft dies nicht zu.

Compression

Wenn dieser Member TRUE ist, ist die Hardwaredatenkomprimierung aktiviert. Andernfalls ist es deaktiviert.

DataPadding

Wenn dieses Element TRUE ist, ist die Datenfüllung aktiviert. Andernfalls ist es deaktiviert. Durch die Datenfüllung wird das Bandstreaming mit konstanter Geschwindigkeit beibehalten.

ReportSetmarks

Wenn dieses Element TRUE ist, ist die Setmark-Berichterstellung aktiviert. Andernfalls ist es deaktiviert.

DefaultBlockSize

Standardmäßige feste Blockgröße des Geräts in Bytes.

MaximumBlockSize

Die maximale Blockgröße des Geräts in Bytes.

MinimumBlockSize

Die mindeste Blockgröße des Geräts in Bytes.

MaximumPartitionCount

Maximale Anzahl von Partitionen, die auf dem Gerät erstellt werden können.

FeaturesLow

Kleinteilige Bits des Gerätefeature-Flags. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
TAPE_DRIVE_COMPRESSION 0x00020000	Das Gerät unterstützt die Hardwaredatenkomprimierung.
TAPE_DRIVE_CLEAN_REQUESTS 0x02000000	Das Gerät kann melden, wenn eine Reinigung erforderlich ist.
TAPE_DRIVE_ECC 0x00010000	Das Gerät unterstützt die Hardwarefehlerkorrektur.
TAPE_DRIVE_EJECT_MEDIA 0x01000000	Das Gerät wirft das Band physisch auf einem Softwareauswurf aus.
TAPE_DRIVE_ERASE_BOP_ONLY 0x00000040	Das Gerät führt den Löschvorgang nur vom Anfang der Partitionsmarkierung aus.
TAPE_DRIVE_ERASE_LONG 0x00000020	Das Gerät führt einen langen Löschvorgang aus.
TAPE_DRIVE_ERASE_IMMEDIATE 0x00000080	Das Gerät führt einen sofortigen Löschvorgang aus, d. h. es wird zurückgegeben, wenn der Löschvorgang beginnt.
TAPE_DRIVE_ERASE_SHORT 0x00000010	Das Gerät führt einen kurzen Löschvorgang aus.
TAPE_DRIVE_FIXED 0x00000001	Das Gerät erstellt feste Datenpartitionen.
TAPE_DRIVE_FIXED_BLOCK 0x00000400	Das Gerät unterstützt den Blockmodus mit fester Länge.
TAPE_DRIVE_GET_ABSOLUTE_BLK 0x00100000	Das Gerät stellt die aktuelle gerätespezifische Blockadresse bereit.
TAPE_DRIVE_GET_LOGICAL_BLK 0x00200000	Das Gerät stellt die aktuelle logische Blockadresse (und die logische Bandpartition) bereit.
TAPE_DRIVE_INITIATOR 0x00000004	Das Gerät erstellt vom Initiator definierte Partitionen.
TAPE_DRIVE_PADDING 0x00040000	Das Gerät unterstützt die Datenfüllung.
TAPE_DRIVE_REPORT_SMKS 0x00080000	Das Gerät unterstützt die Setmark-Berichterstellung.
TAPE_DRIVE_SELECT 0x00000002	Das Gerät erstellt ausgewählte Datenpartitionen.
TAPE_DRIVE_SET_CMP_BOP_ONLY 0x04000000	Das Gerät muss sich am Anfang einer Partition befinden, bevor die Komprimierung aktiviert werden kann.
TAPE_DRIVE_SET_EOT_WZ_SIZE 0x00400000	Das Gerät unterstützt das Festlegen der End-of-Medium-Warnungsgröße.
TAPE_DRIVE_TAPE_CAPACITY 0x00000100	Das Gerät gibt die maximale Kapazität des Bandes zurück.
TAPE_DRIVE_TAPE_REMAINING 0x00000200	Das Gerät gibt die verbleibende Kapazität des Bandes zurück.
TAPE_DRIVE_VARIABLE_BLOCK 0x00000800	Das Gerät unterstützt den Blockmodus mit variabler Länge.
TAPE_DRIVE_WRITE_PROTECT 0x00001000	Das Gerät gibt einen Fehler zurück, wenn das Band schreib- oder schreibgeschützt ist.

FeaturesHigh

Hochgeordnete Bits des Gerätefeatureflags. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert	Bedeutung
TAPE_DRIVE_ABS_BLK_IMMED 0x80002000	Das Gerät verschiebt das Band an eine gerätespezifische Blockadresse und gibt zurück, sobald die Verschiebung beginnt.
TAPE_DRIVE_ABSOLUTE_BLK 0x80001000	Das Gerät verschiebt das Band an eine gerätespezifische Blockadresse.
TAPE_DRIVE_END_OF_DATA 0x80010000	Das Gerät verschiebt das Band an den Datenendemarker in einer Partition.
TAPE_DRIVE_FILEMARKS 0x80040000	Das Gerät verschiebt das Band um eine angegebene Anzahl von Dateizeichen vorwärts (oder rückwärts).
TAPE_DRIVE_LOAD_UNLOAD 0x80000001	Das Gerät aktiviert und deaktiviert das Gerät für weitere Vorgänge.
TAPE_DRIVE_LOAD_UNLD_IMMED 0x80000020	Das Gerät unterstützt sofortige Lade- und Entladevorgänge.
TAPE_DRIVE_LOCK_UNLOCK 0x80000004	Das Gerät aktiviert und deaktiviert den Bandauswurfmechanismus.
TAPE_DRIVE_LOCK_UNLK_IMMED 0x80000080	Das Gerät unterstützt sofortige Sperr- und Entsperrvorgänge.
TAPE_DRIVE_LOG_BLK_IMMED 0x80008000	Das Gerät verschiebt das Band an eine logische Blockadresse in einer Partition und gibt zurück, sobald die Verschiebung beginnt.
TAPE_DRIVE_LOGICAL_BLK 0x80004000	Das Gerät verschiebt das Band an eine logische Blockadresse in einer Partition.
TAPE_DRIVE_RELATIVE_BLKS 0x80020000	Das Gerät verschiebt das Band um eine angegebene Anzahl von Blöcken vorwärts (oder rückwärts).
TAPE_DRIVE_REVERSE_POSITION 0x80400000	Das Gerät verschiebt das Band rückwärts über Blöcke, Dateizeichen oder Setmarkierungen.
TAPE_DRIVE_REWIND_IMMEDIATE 0x80000008	Das Gerät unterstützt den sofortigen Rückspulvorgang.
TAPE_DRIVE_SEQUENTIAL_FMKS 0x80080000	Das Gerät verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen einer angegebenen Anzahl aufeinanderfolgender Dateizeichen.
TAPE_DRIVE_SEQUENTIAL_SMKS 0x80200000	Das Gerät verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen einer angegebenen Anzahl aufeinanderfolgender Setmarkierungen.
TAPE_DRIVE_SET_BLOCK_SIZE 0x80000010	Das Gerät unterstützt das Festlegen der Größe eines logischen Blocks mit fester Länge oder das Festlegen des Blockmodus mit variabler Länge.
TAPE_DRIVE_SET_COMPRESSION 0x80000200	Das Gerät aktiviert und deaktiviert die Hardwaredatenkomprimierung.
TAPE_DRIVE_SET_ECC 0x80000100	Das Gerät aktiviert und deaktiviert die Hardwarefehlerkorrektur.
TAPE_DRIVE_SET_PADDING 0x80000400	Das Gerät aktiviert und deaktiviert den Datenabstand.
TAPE_DRIVE_SET_REPORT_SMKS 0x80000800	Das Gerät aktiviert und deaktiviert die Meldung von Setmarkierungen.
TAPE_DRIVE_SETMARKS 0x80100000	Das Gerät verschiebt das Band um eine angegebene Anzahl von Setmarkierungen vorwärts (oder umgekehrt).
TAPE_DRIVE_SPACE_IMMEDIATE 0x80800000	Das Gerät unterstützt den sofortigen Abstand.
TAPE_DRIVE_TENSION 0x80000002	Das Gerät unterstützt bandspannen.
TAPE_DRIVE_TENSION_IMMED 0x80000040	Das Gerät unterstützt die sofortige Bandspannung.
TAPE_DRIVE_WRITE_FILEMARKS 0x82000000	Das Gerät schreibt Dateizeichen.
TAPE_DRIVE_WRITE_LONG_FMKS 0x88000000	Das Gerät schreibt lange Dateimarkierungen.
TAPE_DRIVE_WRITE_MARK_IMMED 0x90000000	Das Gerät unterstützt das sofortige Schreiben von kurzen und langen Dateimarkierungen.
TAPE_DRIVE_WRITE_SETMARKS 0x81000000	Das Gerät schreibt Setmarks.
TAPE_DRIVE_WRITE_SHORT_FMKS 0x84000000	Das Gerät schreibt kurze Dateimarkierungen.

EOTWarningZoneSize

Gibt die Anzahl der Bytes zwischen der Bandendewarnung und dem physischen Ende des Bandes an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnt.h (windows.h einschließen)

Weitere Informationen

GetTapeParameters

Share via