Partager via

structure TAPE_GET_DRIVE_PARAMETERS (winnt.h)

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