TAPE_GET_DRIVE_PARAMETERS Struktur (minitape.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 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 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, polstert das Gerät Daten mit Nullen, um das Streaming des Bandes aufrechtzuerhalten, bis die Daten bereit sind. Wenn auf FALSE festgelegt ist, ist die Datenfüllung nicht aktiviert.
ReportSetmarks
Wenn sie auf TRUE festgelegt ist, gibt an, dass die Berichtssatzzeichen auf einem Gerät aktiviert sind, das dies unterstützt. Das Gerät meldet Setmarkierungen, die bei Lese- oder Leertastenvorgängen auftreten. Wenn sie 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 mindeste Blockgröße in Bytes an.
MaximumPartitionCount
Gibt die maximale Anzahl von Partitionen an, die das Gerät unterstützt.
FeaturesLow
Gibt die von diesem Laufwerk unterstützten Features an. Der Miniporttreiber legt TAPE_DRIVE_XXX-Flags für vom Laufwerk unterstützte Features fest 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 das Medium 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 Partitionsmarkierung aus. |
| TAPE_DRIVE_ERASE_IMMEDIATE | Das Gerät führt einen sofortigen Löschvorgang aus ?? Das heißt, er 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 vom Initiator definierte 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 die Datenfüllung. |
| 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 | Das Gerät lässt die Komprimierung nur dann zu, 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 schreib- 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 vom Laufwerk unterstützte Features fest 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 mit einer angegebenen 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 um 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 den Datenabstand. |
| TAPE_DRIVE_SET_REPORT_SMKS | Das Gerät aktiviert und deaktiviert die Meldung von Setmarkierungen. |
| TAPE_DRIVE_SETMARKS | Das Gerät verschiebt das Band um eine angegebene Anzahl von Setmarkierungen vorwärts (oder umgekehrt). |
| TAPE_DRIVE_SPACE_IMMEDIATE | Das Gerät unterstützt den sofortigen Abstand. |
| TAPE_DRIVE_TENSION | Das Gerät unterstützt bandspannen. |
| 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 Dateimarkierungen. |
| 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 Byte an. Das Gerät gibt eine Überprüfungsbedingung zurück, wenn es in die Zone eintritt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | minitape.h (include Ntddtape.h, Minitape.h) |