TAPE_GET_DRIVE_PARAMETERS-Struktur (ntddtape.h)
Die TAPE_GET_DRIVE_PARAMETERS-Struktur wird in Verbindung mit der IOCTL_TAPE_GET_DRIVE_PARAMS-Anforderung verwendet, um Informationen zu den Funktionen des Bandlaufwerks abzurufen.
Syntax
typedef struct _TAPE_GET_DRIVE_PARAMETERS {
BOOLEAN ECC;
BOOLEAN Compression;
BOOLEAN DataPadding;
BOOLEAN ReportSetmarks;
ULONG DefaultBlockSize;
ULONG MaximumBlockSize;
ULONG MinimumBlockSize;
ULONG MaximumPartitionCount;
ULONG FeaturesLow;
ULONG FeaturesHigh;
ULONG EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;
Member
ECC
Gibt bei Festlegung auf TRUE an, dass das Gerät eine Hardwarefehlerkorrektur verwendet.
Compression
Gibt bei Festlegung auf TRUE an, dass die Komprimierung auf einem Gerät aktiviert ist, das sie unterstützt. Wenn die Komprimierung aktiviert ist, komprimiert das Gerät die Daten vor dem Schreiben. Wenn dieser Wert auf FALSE festgelegt ist, ist die Komprimierung auf dem Gerät nicht aktiviert.
DataPadding
Gibt bei Festlegung auf TRUE an, dass die Datenauffüllung auf einem Gerät aktiviert ist, das dies unterstützt. Wenn das Auffüllen aktiviert ist, füllt das Gerät Daten mit Nullen, um das Bandstreaming so lange aufrechtzuerhalten, bis die Daten bereit sind. Wenn dieser Wert auf FALSE festgelegt ist, ist der Datenabstand nicht aktiviert.
ReportSetmarks
Gibt bei Festlegung auf TRUE an, dass die Meldung von Setmarkierungen auf einem Gerät aktiviert ist, das dies unterstützt. Das Gerät meldet Setmarkierungen, die während lese- oder leerer Vorgängen gefunden wurden. Wenn dieser Wert auf FALSE festgelegt ist, ist das Melden von Setmarkierungen nicht aktiviert.
DefaultBlockSize
Gibt die Standardblockgröße in Bytes an.
MaximumBlockSize
Gibt die maximale Blockgröße des Bandgeräts oder des zugrunde liegenden Host Bus Adapters (HBA) in Bytes an, je nachdem, welcher Wert kleiner ist.
MinimumBlockSize
Gibt die minimale Blockgröße in Bytes an.
MaximumPartitionCount
Gibt die maximale Anzahl von Partitionen an, die vom Gerät unterstützt werden.
FeaturesLow
Gibt die von diesem Laufwerk unterstützten Features an. Der Miniporttreiber legt TAPE_DRIVE_XXX-Flags für features fest, die vom Laufwerk unterstützt werden, und löscht Flags für nicht unterstützte Features. Aufrufer können die in minitape.h definierten TAPE_DRIVE_XXX-Masken verwenden, um zu bestimmen, ob ein Laufwerk ein bestimmtes Feature unterstützt. Die verfügbaren Masken sind wie folgt:
| Mask | Bedeutung |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | Das Gerät kann melden, ob eine Reinigung erforderlich ist. |
| TAPE_DRIVE_COMPRESSION | Das Gerät unterstützt die Hardwaredatenkomprimierung. |
| TAPE_DRIVE_ECC | Das Gerät unterstützt die Hardwarefehlerkorrektur. |
| TAPE_DRIVE_EJECT_MEDIA | Das Gerät wirft die Medien aus. |
| TAPE_DRIVE_EOT_WZ_SIZE | Das Gerät kann die Größe der Zonenendwarnung melden. |
| TAPE_DRIVE_ERASE_BOP_ONLY | Das Gerät führt den Löschvorgang nur vom Anfang der Partitionsmarker aus. |
| TAPE_DRIVE_ERASE_IMMEDIATE | Das Gerät führt einen sofortigen Löschvorgang aus? Das heißt, es wird zurückgegeben, wenn der Löschvorgang beginnt. |
| TAPE_DRIVE_ERASE_LONG | Das Gerät führt einen langen Löschvorgang aus. |
| TAPE_DRIVE_ERASE_SHORT | Das Gerät führt einen kurzen Löschvorgang aus. |
| TAPE_DRIVE_FIXED | Das Gerät erstellt feste Datenpartitionen. |
| TAPE_DRIVE_FIXED_BLOCK | Das Gerät unterstützt den Blockmodus mit fester Länge. |
| TAPE_DRIVE_INITIATOR | Das Gerät erstellt initiatordefinierte Partitionen. |
| TAPE_DRIVE_GET_ABSOLUTE_BLK | Das Gerät stellt die aktuelle gerätespezifische Blockadresse bereit. |
| TAPE_DRIVE_GET_LOGICAL_BLK | Das Gerät stellt die aktuelle logische Blockadresse (und die logische Bandpartition) bereit. |
| TAPE_DRIVE_PADDING | Das Gerät unterstützt den Datenabstand. |
| TAPE_DRIVE_REPORT_SMKS | Das Gerät unterstützt die Setmark-Berichterstellung. |
| TAPE_DRIVE_RESERVED_BIT | Eine Maske, die ein reserviertes Bit identifiziert. Treiber dürfen dieses Bit nicht festlegen. |
| TAPE_DRIVE_SELECT | Das Gerät erstellt ausgewählte Datenpartitionen. |
| TAPE_DRIVE_SET_CMP_BOP_ONLY | Auf dem Gerät kann die Komprimierung nur aktiviert werden, wenn sich der Lese-/Schreibkopf am Anfang der Partition befindet. |
| TAPE_DRIVE_SET_EOT_WZ_SIZE | Das Gerät unterstützt das Festlegen der End-of-Medium-Warnungsgröße. |
| TAPE_DRIVE_TAPE_CAPACITY | Das Gerät gibt die maximale Kapazität des Bandes zurück. |
| TAPE_DRIVE_TAPE_REMAINING | Das Gerät gibt die verbleibende Kapazität des Bandes zurück. |
| TAPE_DRIVE_VARIABLE_BLOCK | Das Gerät unterstützt den Blockmodus mit variabler Länge. |
| TAPE_DRIVE_WRITE_PROTECT | Das Gerät gibt einen Fehler zurück, wenn das Band schreibfähig oder schreibgeschützt ist. |
FeaturesHigh
Gibt die zusätzlichen Features an, die von diesem Laufwerk unterstützt werden, wenn TAPE_DRIVE_HIGH_FEATURES in FeaturesLow festgelegt ist. Der Miniporttreiber legt TAPE_DRIVE_XXX-Flags für features fest, die vom Laufwerk unterstützt werden, und löscht Flags für nicht unterstützte Features. Aufrufer können die in minitape.h definierten TAPE_DRIVE_XXX-Masken verwenden, um zu bestimmen, ob ein Laufwerk ein bestimmtes Feature unterstützt.
| Mask | Bedeutung |
|---|---|
| TAPE_DRIVE_ABS_BLK_IMMED | Das Gerät verschiebt das Band an eine gerätespezifische Blockadresse und gibt zurück, sobald die Verschiebung beginnt. |
| TAPE_DRIVE_ABSOLUTE_BLK | Das Gerät verschiebt das Band an eine gerätespezifische Blockadresse. |
| TAPE_DRIVE_END_OF_DATA | Das Gerät verschiebt das Band an den Datenendemarker in einer Partition. |
| TAPE_DRIVE_FILEMARKS | Das Gerät verschiebt das Band um eine angegebene Anzahl von Dateizeichen vorwärts (oder rückwärts). |
| TAPE_DRIVE_FORMAT | Das Gerät kann die Medien formatieren. |
| TAPE_DRIVE_FORMAT_IMMEDIATE | Das Gerät kann die Medien als sofortigen Befehl formatieren. |
| TAPE_DRIVE_HIGH_FEATURES | Eine Bitmaske, die die Bits angibt, die hohen Features entsprechen. |
| TAPE_DRIVE_LOAD_UNLOAD | Das Gerät aktiviert und deaktiviert das Gerät für weitere Vorgänge. |
| TAPE_DRIVE_LOAD_UNLD_IMMED | Das Gerät unterstützt sofortige Lade- und Entladevorgänge. |
| TAPE_DRIVE_LOCK_UNLOCK | Das Gerät aktiviert und deaktiviert den Bandauswurfmechanismus. |
| TAPE_DRIVE_LOCK_UNLK_IMMED | Das Gerät unterstützt sofortige Sperr- und Entsperrvorgänge. |
| TAPE_DRIVE_LOG_BLK_IMMED | 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 | Das Gerät verschiebt das Band an eine logische Blockadresse in einer Partition. |
| TAPE_DRIVE_RELATIVE_BLKS | Das Gerät verschiebt das Band eine angegebene Anzahl von Blöcken vorwärts (oder rückwärts). |
| TAPE_DRIVE_REVERSE_POSITION | Das Gerät verschiebt das Band rückwärts über Blöcke, Dateizeichen oder Setmarkierungen. |
| TAPE_DRIVE_REWIND_IMMEDIATE | Das Gerät unterstützt den sofortigen Rückspulvorgang. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | Das Gerät verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen einer angegebenen Anzahl aufeinanderfolgender Dateizeichen. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | 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 | 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 | Das Gerät aktiviert und deaktiviert die Hardwaredatenkomprimierung. |
| TAPE_DRIVE_SET_ECC | Das Gerät aktiviert und deaktiviert die Hardwarefehlerkorrektur. |
| TAPE_DRIVE_SET_PADDING | Das Gerät aktiviert und deaktiviert die Datenfüllung. |
| TAPE_DRIVE_SET_REPORT_SMKS | Das Gerät aktiviert und deaktiviert die Berichterstellung von Setmarkierungen. |
| TAPE_DRIVE_SETMARKS | Das Gerät verschiebt das Band mit einer angegebenen Anzahl von Setmarkierungen vorwärts (oder umgekehrt). |
| TAPE_DRIVE_SPACE_IMMEDIATE | Das Gerät unterstützt sofortige Abstände. |
| TAPE_DRIVE_TENSION | Das Gerät unterstützt die Bandspannung. |
| TAPE_DRIVE_TENSION_IMMED | Das Gerät unterstützt die sofortige Bandspannung. |
| TAPE_DRIVE_WRITE_FILEMARKS | Das Gerät schreibt Dateizeichen. |
| TAPE_DRIVE_WRITE_LONG_FMKS | Das Gerät schreibt lange Dateimarkierungen. |
| TAPE_DRIVE_WRITE_MARK_IMMED | Das Gerät unterstützt das sofortige Schreiben von kurzen und langen Dateizeichen. |
| TAPE_DRIVE_WRITE_SETMARKS | Das Gerät schreibt Setmarks. |
| TAPE_DRIVE_WRITE_SHORT_FMKS | Das Gerät schreibt kurze Dateimarkierungen. |
EOTWarningZoneSize
Gibt die Größe der Frühwarnzone am Ende des Bandes in Bytes an. Das Gerät gibt eine Prüfbedingung zurück, wenn es in die Zone eintritt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddtape.h (include Ntddtape.h, Minitape.h) |