structure TAPE_GET_DRIVE_PARAMETERS (ntddtape.h)
La structure TAPE_GET_DRIVE_PARAMETERS est utilisée conjointement avec la demande de 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 des erreurs matérielles.
Compression
Lorsqu’elle est définie sur TRUE, indique que la compression est activée sur un appareil qui le prend en charge. Lorsque la compression est activée, l’appareil compresse les données avant de les écrire. Lorsqu’elle est définie sur faux, la compression n’est pas activée sur l’appareil.
DataPadding
Lorsqu’il est défini sur TRUE, indique que le remplissage de données est activé sur un appareil qui le prend en charge. Lorsque le remplissage est activé, l’appareil met en place des données avec zéros pour conserver la diffusion en continu sur bande jusqu’à ce que les données ne sont pas prêtes. Lorsque la valeur est définie sur FALSE, le remplissage des données n’est pas activé.
ReportSetmarks
Lorsqu’elle est définie sur TRUE, indique que les marques de définition de rapports sont activées sur un appareil qui le prend en charge. Les rapports d’appareil définissent des filigranes rencontrés pendant les opérations de lecture ou d’espace. Lorsque la valeur est définie sur FALSE, les filigranes de création de rapports ne sont pas activés.
DefaultBlockSize
Indique la taille de bloc par défaut, en octets.
MaximumBlockSize
Indique la taille maximale de bloc, en octets, de l’appareil à bande ou de l’adaptateur de bus hôte sous-jacent (HBA), selon la valeur la plus petite.
MinimumBlockSize
Indique la taille minimale du bloc, en octets.
MaximumPartitionCount
Indique le nombre maximal de partitions pris en charge par l’appareil.
FeaturesLow
Indique les fonctionnalités prises en charge par ce lecteur. Le pilote miniport définit TAPE_DRIVE_indicateurs de XXX 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 masquesXXX TAPE_DRIVE_ définis dans minitape.h pour déterminer si un lecteur prend en charge une fonctionnalité particulière. Les masques disponibles sont les suivants :
| Masque | Signification |
|---|---|
| TAPE_DRIVE_CLEAN_REQUESTS | L’appareil peut signaler 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 fin de la taille d’avertissement 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 longue. |
| TAPE_DRIVE_ERASE_SHORT | L’appareil effectue une opération d’effacement courte. |
| 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 à l’appareil actuelle. |
| 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 la compression à activer lorsque la tête de lecture/écriture est 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 taille. |
| 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éfinie dans FeaturesLow. Le pilote miniport définit TAPE_DRIVE_indicateurs de XXX 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.
| Masque | 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 de 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 filigranes de fichiers. |
| 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 immédiates de verrouillage et de déverrouillage. |
| 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 les blocs, les filigranes de fichier ou les filigranes définis. |
| TAPE_DRIVE_REWIND_IMMEDIATE | L’appareil prend en charge l’opération de rembobinage immédiate. |
| TAPE_DRIVE_SEQUENTIAL_FMKS | L’appareil déplace la bande vers l’avant (ou vers l’arrière) vers la première occurrence d’un nombre spécifié de marques de fichier consécutives. |
| TAPE_DRIVE_SEQUENTIAL_SMKS | L’appareil déplace la bande vers l’avant (ou vers l’arrière) vers la première occurrence d’un nombre spécifié de filigranes 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 la définition du 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 l’inverse) un nombre spécifié de filigranes. |
| TAPE_DRIVE_SPACE_IMMEDIATE | L’appareil prend en charge l’espacement immédiat. |
| TAPE_DRIVE_TENSION | L’appareil prend en charge la tension de bande. |
| TAPE_DRIVE_TENSION_IMMED | L’appareil prend en charge la tension de bande immédiate. |
| TAPE_DRIVE_WRITE_FILEMARKS | L’appareil écrit des filigranes de fichier. |
| TAPE_DRIVE_WRITE_LONG_FMKS | L’appareil écrit des filigranes de fichiers longs. |
| TAPE_DRIVE_WRITE_MARK_IMMED | L’appareil prend en charge l’écriture immédiate de filigranes de fichiers courts et longs. |
| TAPE_DRIVE_WRITE_SETMARKS | L’appareil écrit des filigranes. |
| TAPE_DRIVE_WRITE_SHORT_FMKS | L’appareil écrit des filigranes de fichiers 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 vérification lorsqu’il entre dans la zone.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddtape.h (include Ntddtape.h, Minitape.h) |