TAPE_GET_DRIVE_PARAMETERS structure (minitape.h)
La structure TAPE_GET_DRIVE_PARAMETERS est utilisée conjointement avec la demande IOCTL_TAPE_GET_DRIVE_PARAMS pour récupérer des informations sur les fonctionnalités du lecteur de bande.
Syntaxe
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;
Membres
ECC
Lorsqu’il est défini sur TRUE, indique que l’appareil utilise la correction d’erreur matérielle.
Compression
Lorsqu’elle est définie sur TRUE, indique que la compression est activée sur un appareil qui la prend en charge. Lorsque la compression est activée, l’appareil compresse les données avant de les écrire. Lorsque la valeur est FALSE, la compression n’est pas activée sur l’appareil.
DataPadding
Lorsqu’il est défini sur TRUE, indique que le remplissage des données est activé sur un appareil qui le prend en charge. Lorsque le remplissage est activé, l’appareil rembourse les données avec des zéros pour conserver la diffusion sur bande jusqu’à ce que les données sont prêtes. Lorsque la valeur est FALSE, le remplissage des données n’est pas activé.
ReportSetmarks
Lorsqu’il est défini sur TRUE, indique que les setmarks de création de rapports sont activés sur un appareil qui le prend en charge. L’appareil signale les setmarks rencontrés pendant les opérations de lecture ou d’espace. Lorsque la valeur est FALSE, la création de rapports setmarks n’est pas activée.
DefaultBlockSize
Indique la taille de bloc par défaut, en octets.
MaximumBlockSize
Indique la taille de bloc maximale, en octets, du périphérique à bande ou de l’adaptateur de bus hôte (HBA) sous-jacent, selon la taille la plus petite.
MinimumBlockSize
Indique la taille de bloc minimale, en octets.
MaximumPartitionCount
Indique le nombre maximal de partitions que l’appareil prend en charge.
FeaturesLow
Indique les fonctionnalités prises en charge par ce lecteur. Le pilote miniport définit TAPE_DRIVE_ indicateursXXX pour les fonctionnalités prises en charge par le lecteur et efface les indicateurs pour les fonctionnalités non prises en charge. Les appelants peuvent utiliser les masques TAPE_DRIVE_XXX définis dans minitape.h pour déterminer si un lecteur prend en charge une fonctionnalité particulière. Les masques disponibles sont les suivants :
| Mask | Signification |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | L’appareil peut indiquer s’il nécessite un nettoyage. |
| TAPE_DRIVE_COMPRESSION | L’appareil prend en charge la compression des données matérielles. |
| TAPE_DRIVE_ECC | L’appareil prend en charge la correction des erreurs matérielles. |
| TAPE_DRIVE_EJECT_MEDIA | L’appareil éjecte le média. |
| TAPE_DRIVE_EOT_WZ_SIZE | L’appareil peut signaler la taille de l’avertissement de fin de zone. |
| TAPE_DRIVE_ERASE_BOP_ONLY | L’appareil effectue l’opération d’effacement à partir du marqueur de début de partition uniquement. |
| TAPE_DRIVE_ERASE_IMMEDIATE | L’appareil effectue une opération d’effacement immédiate ?? autrement dit, elle retourne lorsque l’opération d’effacement commence. |
| TAPE_DRIVE_ERASE_LONG | L’appareil effectue une opération d’effacement de longue durée. |
| TAPE_DRIVE_ERASE_SHORT | L’appareil effectue une courte opération d’effacement. |
| TAPE_DRIVE_FIXED | L’appareil crée des partitions de données fixes. |
| TAPE_DRIVE_FIXED_BLOCK | L’appareil prend en charge le mode bloc de longueur fixe. |
| TAPE_DRIVE_INITIATOR | L’appareil crée des partitions définies par l’initiateur. |
| TAPE_DRIVE_GET_ABSOLUTE_BLK | L’appareil fournit l’adresse de bloc spécifique actuelle à l’appareil. |
| TAPE_DRIVE_GET_LOGICAL_BLK | L’appareil fournit l’adresse de bloc logique actuelle (et la partition de bande logique). |
| TAPE_DRIVE_PADDING | L’appareil prend en charge le remplissage des données. |
| TAPE_DRIVE_REPORT_SMKS | L’appareil prend en charge la création de rapports setmark. |
| TAPE_DRIVE_RESERVED_BIT | Masque qui identifie un bit réservé. Les pilotes ne doivent pas définir ce bit. |
| TAPE_DRIVE_SELECT | L’appareil crée des partitions de données sélectionnées. |
| TAPE_DRIVE_SET_CMP_BOP_ONLY | L’appareil autorise uniquement l’activation de la compression lorsque la tête de lecture/écriture se trouve au début de la partition. |
| TAPE_DRIVE_SET_EOT_WZ_SIZE | L’appareil prend en charge la définition de la taille d’avertissement de fin de moyenne. |
| TAPE_DRIVE_TAPE_CAPACITY | L’appareil retourne la capacité maximale de la bande. |
| TAPE_DRIVE_TAPE_REMAINING | L’appareil retourne la capacité restante de la bande. |
| TAPE_DRIVE_VARIABLE_BLOCK | L’appareil prend en charge le mode bloc de longueur variable. |
| TAPE_DRIVE_WRITE_PROTECT | L’appareil retourne une erreur si la bande est activée en écriture ou protégée en écriture. |
FeaturesHigh
Indique les fonctionnalités supplémentaires prises en charge par ce lecteur si TAPE_DRIVE_HIGH_FEATURES est défini dans FeaturesLow. Le pilote miniport définit TAPE_DRIVE_ indicateursXXX pour les fonctionnalités prises en charge par le lecteur et efface les indicateurs pour les fonctionnalités non prises en charge. Les appelants peuvent utiliser les masques TAPE_DRIVE_XXX définis dans minitape.h pour déterminer si un lecteur prend en charge une fonctionnalité particulière.
| Mask | Signification |
|---|---|
| TAPE_DRIVE_ABS_BLK_IMMED | L’appareil déplace la bande vers une adresse de bloc spécifique à l’appareil et retourne dès que le déplacement commence. |
| TAPE_DRIVE_ABSOLUTE_BLK | L’appareil déplace la bande vers une adresse de bloc spécifique à l’appareil. |
| TAPE_DRIVE_END_OF_DATA | L’appareil déplace la bande vers le marqueur de fin de données dans une partition. |
| TAPE_DRIVE_FILEMARKS | L’appareil déplace la bande vers l’avant (ou vers l’arrière) un nombre spécifié de repères de fichier. |
| TAPE_DRIVE_FORMAT | L’appareil peut mettre en forme le média. |
| TAPE_DRIVE_FORMAT_IMMEDIATE | L’appareil peut mettre en forme le média en tant que commande immédiate. |
| TAPE_DRIVE_HIGH_FEATURES | Masque de bits qui indique les bits qui correspondent à des caractéristiques élevées. |
| TAPE_DRIVE_LOAD_UNLOAD | L’appareil active et désactive l’appareil pour d’autres opérations. |
| TAPE_DRIVE_LOAD_UNLD_IMMED | L’appareil prend en charge les opérations de chargement et de déchargement immédiats. |
| TAPE_DRIVE_LOCK_UNLOCK | L’appareil active et désactive le mécanisme d’éjection de bande. |
| TAPE_DRIVE_LOCK_UNLK_IMMED | L’appareil prend en charge les opérations de verrouillage et de déverrouillage immédiats. |
| TAPE_DRIVE_LOG_BLK_IMMED | L’appareil déplace la bande vers une adresse de bloc logique dans une partition et retourne dès que le déplacement commence. |
| TAPE_DRIVE_LOGICAL_BLK | L’appareil déplace la bande vers une adresse de bloc logique dans une partition. |
| TAPE_DRIVE_RELATIVE_BLKS | L’appareil déplace la bande vers l’avant (ou vers l’arrière) un nombre spécifié de blocs. |
| TAPE_DRIVE_REVERSE_POSITION | L’appareil déplace la bande vers l’arrière sur des blocs, des repères de fichier ou des setmarks. |
| TAPE_DRIVE_REWIND_IMMEDIATE | L’appareil prend en charge l’opération de rembobinage immédiat. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | L’appareil déplace la bande vers l’avant (ou vers l’arrière) jusqu’à la première occurrence d’un nombre spécifié de repères de fichier consécutifs. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | L’appareil déplace la bande vers l’avant (ou vers l’arrière) jusqu’à la première occurrence d’un nombre spécifié de setmarks consécutifs. |
| TAPE_DRIVE_SET_BLOCK_SIZE | L’appareil prend en charge la définition de la taille d’un bloc logique de longueur fixe ou le mode bloc de longueur variable. |
| TAPE_DRIVE_SET_COMPRESSION | L’appareil active et désactive la compression des données matérielles. |
| TAPE_DRIVE_SET_ECC | L’appareil active et désactive la correction des erreurs matérielles. |
| TAPE_DRIVE_SET_PADDING | L’appareil active et désactive le remplissage des données. |
| TAPE_DRIVE_SET_REPORT_SMKS | L’appareil active et désactive la création de rapports de setmarks. |
| TAPE_DRIVE_SETMARKS | L’appareil déplace la bande vers l’avant (ou inverse) un nombre spécifié de setmarks. |
| TAPE_DRIVE_SPACE_IMMEDIATE | L’appareil prend en charge l’espacement immédiat. |
| TAPE_DRIVE_TENSION | L’appareil prend en charge le tensionnement des bandes. |
| TAPE_DRIVE_TENSION_IMMED | L’appareil prend en charge le tensionnement immédiat de la bande. |
| TAPE_DRIVE_WRITE_FILEMARKS | L’appareil écrit des repères de fichier. |
| TAPE_DRIVE_WRITE_LONG_FMKS | L’appareil écrit des repères de fichier longs. |
| TAPE_DRIVE_WRITE_MARK_IMMED | L’appareil prend en charge l’écriture immédiate de caractères courts et longs. |
| TAPE_DRIVE_WRITE_SETMARKS | L’appareil écrit setmarks. |
| TAPE_DRIVE_WRITE_SHORT_FMKS | L’appareil écrit des repères de fichier courts. |
EOTWarningZoneSize
Indique la taille en octets de la zone d’avertissement précoce vers la fin de la bande. L’appareil retourne une condition de case activée lorsqu’il entre dans la zone.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | minitape.h (inclure Ntddtape.h, Minitape.h) |