structure TAPE_GET_DRIVE_PARAMETERS (winnt.h)

Article
08/27/2023

La structure TAPE_GET_DRIVE_PARAMETERS décrit le lecteur de bande. Il est utilisé par la fonction GetTapeParameters .

Syntaxe

typedef struct _TAPE_GET_DRIVE_PARAMETERS {
  BOOLEAN ECC;
  BOOLEAN Compression;
  BOOLEAN DataPadding;
  BOOLEAN ReportSetmarks;
  DWORD   DefaultBlockSize;
  DWORD   MaximumBlockSize;
  DWORD   MinimumBlockSize;
  DWORD   MaximumPartitionCount;
  DWORD   FeaturesLow;
  DWORD   FeaturesHigh;
  DWORD   EOTWarningZoneSize;
} TAPE_GET_DRIVE_PARAMETERS, *PTAPE_GET_DRIVE_PARAMETERS;

Membres

ECC

Si ce membre a la valeur TRUE, l’appareil prend en charge la correction d’erreur matérielle. Sinon, elle ne l'a pas.

Compression

Si ce membre a la valeur TRUE, la compression des données matérielles est activée. Sinon, elle est désactivée.

DataPadding

Si ce membre a la valeur TRUE, le remplissage des données est activé. Sinon, elle est désactivée. Le remplissage de données maintient la diffusion en continu de bandes à une vitesse constante.

ReportSetmarks

Si ce membre a la valeur TRUE, la création de rapports setmark est activée. Sinon, elle est désactivée.

DefaultBlockSize

Taille de bloc fixe par défaut de l’appareil, en octets.

MaximumBlockSize

Taille de bloc maximale de l’appareil, en octets.

MinimumBlockSize

Taille minimale du bloc de l’appareil, en octets.

MaximumPartitionCount

Nombre maximal de partitions pouvant être créées sur l’appareil.

FeaturesLow

Bits de faible ordre de l’indicateur de fonctionnalités de l’appareil. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
TAPE_DRIVE_COMPRESSION 0x00020000	L’appareil prend en charge la compression des données matérielles.
TAPE_DRIVE_CLEAN_REQUESTS 0x02000000	L’appareil peut signaler si un nettoyage est nécessaire.
TAPE_DRIVE_ECC 0x00010000	L’appareil prend en charge la correction des erreurs matérielles.
TAPE_DRIVE_EJECT_MEDIA 0x01000000	L’appareil éjecte physiquement la bande sur un éjection de logiciel.
TAPE_DRIVE_ERASE_BOP_ONLY 0x00000040	L’appareil effectue l’opération d’effacement à partir du marqueur de début de partition uniquement.
TAPE_DRIVE_ERASE_LONG 0x00000020	L’appareil effectue une opération d’effacement de longue durée.
TAPE_DRIVE_ERASE_IMMEDIATE 0x00000080	L’appareil effectue une opération d’effacement immédiate, c’est-à-dire qu’il retourne au début de l’opération d’effacement.
TAPE_DRIVE_ERASE_SHORT 0x00000010	L’appareil effectue une courte opération d’effacement.
TAPE_DRIVE_FIXED 0x00000001	L’appareil crée des partitions de données fixes.
TAPE_DRIVE_FIXED_BLOCK 0x00000400	L’appareil prend en charge le mode bloc de longueur fixe.
TAPE_DRIVE_GET_ABSOLUTE_BLK 0x00100000	L’appareil fournit l’adresse de bloc actuelle spécifique à l’appareil.
TAPE_DRIVE_GET_LOGICAL_BLK 0x00200000	L’appareil fournit l’adresse de bloc logique actuelle (et la partition de bande logique).
TAPE_DRIVE_INITIATOR 0x00000004	L’appareil crée des partitions définies par l’initiateur.
TAPE_DRIVE_PADDING 0x00040000	L’appareil prend en charge le remplissage des données.
TAPE_DRIVE_REPORT_SMKS 0x00080000	L’appareil prend en charge la création de rapports setmark.
TAPE_DRIVE_SELECT 0x00000002	L’appareil crée des partitions de données sélectionnées.
TAPE_DRIVE_SET_CMP_BOP_ONLY 0x04000000	L’appareil doit se trouver au début d’une partition avant de pouvoir activer la compression.
TAPE_DRIVE_SET_EOT_WZ_SIZE 0x00400000	L’appareil prend en charge la définition de la taille d’avertissement de fin de moyenne.
TAPE_DRIVE_TAPE_CAPACITY 0x00000100	L’appareil retourne la capacité maximale de la bande.
TAPE_DRIVE_TAPE_REMAINING 0x00000200	L’appareil retourne la capacité restante de la bande.
TAPE_DRIVE_VARIABLE_BLOCK 0x00000800	L’appareil prend en charge le mode bloc de longueur variable.
TAPE_DRIVE_WRITE_PROTECT 0x00001000	L’appareil retourne une erreur si la bande est activée en écriture ou protégée en écriture.

FeaturesHigh

Bits d’ordre élevé de l’indicateur de fonctionnalités de l’appareil. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
TAPE_DRIVE_ABS_BLK_IMMED 0x80002000	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 0x80001000	L’appareil déplace la bande vers une adresse de bloc spécifique à l’appareil.
TAPE_DRIVE_END_OF_DATA 0x80010000	L’appareil déplace la bande vers le marqueur de fin de données dans une partition.
TAPE_DRIVE_FILEMARKS 0x80040000	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_LOAD_UNLOAD 0x80000001	L’appareil active et désactive l’appareil pour d’autres opérations.
TAPE_DRIVE_LOAD_UNLD_IMMED 0x80000020	L’appareil prend en charge les opérations de chargement et de déchargement immédiats.
TAPE_DRIVE_LOCK_UNLOCK 0x80000004	L’appareil active et désactive le mécanisme d’éjection de bande.
TAPE_DRIVE_LOCK_UNLK_IMMED 0x80000080	L’appareil prend en charge les opérations de verrouillage et de déverrouillage immédiats.
TAPE_DRIVE_LOG_BLK_IMMED 0x80008000	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 0x80004000	L’appareil déplace la bande vers une adresse de bloc logique dans une partition.
TAPE_DRIVE_RELATIVE_BLKS 0x80020000	L’appareil déplace la bande vers l’avant (ou vers l’arrière) un nombre spécifié de blocs.
TAPE_DRIVE_REVERSE_POSITION 0x80400000	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 0x80000008	L’appareil prend en charge l’opération de rembobinage immédiat.
TAPE_DRIVE_SEQUENTIAL_FMKS 0x80080000	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 0x80200000	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 0x80000010	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 0x80000200	L’appareil active et désactive la compression des données matérielles.
TAPE_DRIVE_SET_ECC 0x80000100	L’appareil active et désactive la correction des erreurs matérielles.
TAPE_DRIVE_SET_PADDING 0x80000400	L’appareil active et désactive le remplissage des données.
TAPE_DRIVE_SET_REPORT_SMKS 0x80000800	L’appareil active et désactive la création de rapports de setmarks.
TAPE_DRIVE_SETMARKS 0x80100000	L’appareil déplace la bande vers l’avant (ou inverse) un nombre spécifié de setmarks.
TAPE_DRIVE_SPACE_IMMEDIATE 0x80800000	L’appareil prend en charge l’espacement immédiat.
TAPE_DRIVE_TENSION 0x80000002	L’appareil prend en charge le tensionnement des bandes.
TAPE_DRIVE_TENSION_IMMED 0x80000040	L’appareil prend en charge le tensionnement immédiat de la bande.
TAPE_DRIVE_WRITE_FILEMARKS 0x82000000	L’appareil écrit des repères de fichier.
TAPE_DRIVE_WRITE_LONG_FMKS 0x88000000	L’appareil écrit des repères de fichier longs.
TAPE_DRIVE_WRITE_MARK_IMMED 0x90000000	L’appareil prend en charge l’écriture immédiate de caractères courts et longs.
TAPE_DRIVE_WRITE_SETMARKS 0x81000000	L’appareil écrit setmarks.
TAPE_DRIVE_WRITE_SHORT_FMKS 0x84000000	L’appareil écrit des repères de fichier courts.

EOTWarningZoneSize

Indique le nombre d’octets entre l’avertissement de fin de bande et la fin physique de la bande.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	winnt.h (inclure Windows.h)

Voir aussi

GetTapeParameters

Partager via