TAPE_GET_DRIVE_PARAMETERS Struktur (ntddtape.h)
Die TAPE_GET_DRIVE_PARAMETERS-Struktur wird in Verbindung mit der IOCTL_TAPE_GET_DRIVE_PARAMS Anforderung zum Abrufen von Informationen über die Funktionen des Bandlaufwerks verwendet.
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;
Angehörige
ECC
Wenn dieser Wert auf TRUEfestgelegt ist, wird angegeben, dass das Gerät hardwarefehlerkorrektur verwendet.
Compression
Wenn dieser Wert auf TRUEfestgelegt ist, wird angegeben, dass die Komprimierung auf einem Gerät aktiviert ist, das es unterstützt. Wenn die Komprimierung aktiviert ist, komprimiert das Gerät Daten vor dem Schreiben. Wenn dieser Wert auf FALSE-festgelegt ist, ist die Komprimierung auf dem Gerät nicht aktiviert.
DataPadding
Wenn dieser Wert auf TRUEfestgelegt ist, wird angegeben, dass der Datenabstand auf einem Gerät aktiviert ist, das ihn unterstützt. Wenn der Abstand aktiviert ist, werden die Gerätepaddaten mit Nullen angezeigt, um das Bandstreaming beizubehalten, bis Daten bereit sind. Wenn dieser Wert auf FALSE-festgelegt ist, ist der Datenabstand nicht aktiviert.
ReportSetmarks
Wenn dieser Wert auf TRUE-festgelegt ist, wird angegeben, dass die Berichtssatzzeichen auf einem Gerät aktiviert sind, das es unterstützt. Das Gerät meldet Setmarks, die bei Lese- oder Speicherplatzvorgängen aufgetreten sind. Wenn dieser Wert auf FALSE-festgelegt ist, ist die Berichtssatzmarkierungen nicht aktiviert.
DefaultBlockSize
Gibt die Standardblockgröße in Byte an.
MaximumBlockSize
Gibt die maximale Blockgröße (in Byte) des Bandgeräts oder des zugrunde liegenden Hostbusadapters (HBA) an, je nachdem, welcher Wert kleiner ist.
MinimumBlockSize
Gibt die minimale Blockgröße in Byte 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 Features, die nicht unterstützt werden. Anrufer 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:
| Maske | Bedeutung |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | Das Gerät kann melden, ob es eine Reinigung erfordert. |
| 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 überwirft die Medien. |
| TAPE_DRIVE_EOT_WZ_SIZE | Das Gerät kann die Warnungsgröße für das Ende der Zone 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 Radiervorgang aus?? d. h., es wird zurückgegeben, wenn der Löschvorgang beginnt. |
| TAPE_DRIVE_ERASE_LONG | Das Gerät führt einen langen Radiervorgang aus. |
| TAPE_DRIVE_ERASE_SHORT | Das Gerät führt einen kurzen Radiervorgang 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 | Das Gerät ermöglicht nur die Aktivierung der Komprimierung, wenn sich der Lese-/Schreibkopf am Anfang der Partition befindet. |
| TAPE_DRIVE_SET_EOT_WZ_SIZE | Das Gerät unterstützt das Festlegen der Mittleren 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 variabler Länge. |
| TAPE_DRIVE_WRITE_PROTECT | Das Gerät gibt einen Fehler zurück, wenn das Band schreibgeschützt oder schreibgeschützt ist. |
FeaturesHigh
Gibt die zusätzlichen Features an, die von diesem Laufwerk unterstützt werden, wenn TAPE_DRIVE_HIGH_FEATURES in FeaturesLowfestgelegt ist. Der Miniporttreiber legt TAPE_DRIVE_XXX- Flags für vom Laufwerk unterstützte Features fest und löscht Flags für Features, die nicht unterstützt werden. Anrufer können die in minitape.h-definierten TAPE_DRIVE_XXX- Masken verwenden, um zu bestimmen, ob ein Laufwerk ein bestimmtes Feature unterstützt.
| Maske | Bedeutung |
|---|---|
| TAPE_DRIVE_ABS_BLK_IMMED | Das Gerät verschiebt das Band auf eine gerätespezifische Blockadresse und gibt zurück, sobald die Verschiebung beginnt. |
| TAPE_DRIVE_ABSOLUTE_BLK | Das Gerät verschiebt das Band auf eine gerätespezifische Blockadresse. |
| TAPE_DRIVE_END_OF_DATA | Das Gerät verschiebt das Band an die Datenendemarkierung in einer Partition. |
| TAPE_DRIVE_FILEMARKS | Das Gerät verschiebt das Band vorwärts (oder rückwärts) eine bestimmte Anzahl von Dateizeichen. |
| 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 diese 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 Band-Ejection-Mechanismus. |
| 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 auf eine logische Blockadresse in einer Partition und gibt zurück, sobald die Verschiebung beginnt. |
| TAPE_DRIVE_LOGICAL_BLK | Das Gerät verschiebt das Band auf eine logische Blockadresse in einer Partition. |
| TAPE_DRIVE_RELATIVE_BLKS | Das Gerät verschiebt das Band vorwärts (oder rückwärts) eine bestimmte Anzahl von Blöcken. |
| TAPE_DRIVE_REVERSE_POSITION | Das Gerät verschiebt das Band rückwärts über Blöcke, Dateizeichen oder Setzeichen. |
| TAPE_DRIVE_REWIND_IMMEDIATE | Das Gerät unterstützt den sofortigen Rückspulenvorgang. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | Das Gerät verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen einer angegebenen Anzahl aufeinander folgender Dateizeichen. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | Das Gerät verschiebt das Band vorwärts (oder rückwärts) zum ersten Vorkommen einer angegebenen Anzahl aufeinander folgender Satzzeichen. |
| 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 Berichterstellung von Setmarks. |
| TAPE_DRIVE_SETMARKS | Das Gerät verschiebt das Band vorwärts (oder umgekehrt) eine bestimmte Anzahl von Satzzeichen. |
| TAPE_DRIVE_SPACE_IMMEDIATE | Das Gerät unterstützt den sofortigen Abstand. |
| TAPE_DRIVE_TENSION | Das Gerät unterstützt Bandspannungen. |
| TAPE_DRIVE_TENSION_IMMED | Das Gerät unterstützt sofortige Bandspannungen. |
| TAPE_DRIVE_WRITE_FILEMARKS | Das Gerät schreibt Dateizeichen. |
| TAPE_DRIVE_WRITE_LONG_FMKS | Das Gerät schreibt lange Dateizeichen. |
| 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 Dateizeichen. |
EOTWarningZoneSize
Gibt die Größe in Byte der Frühwarnzone am Ende des Bandes an. Das Gerät gibt eine Überprüfungsbedingung zurück, wenn es in die Zone eintritt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddtape.h (include Ntddtape.h, Minitape.h) |