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