TAPE_GET_DRIVE_PARAMETERS-Struktur (winnt.h)

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