structure GET_CHANGER_PARAMETERS (ntddchgr.h)

Article
02/07/2025

Récupère les caractéristiques du changeur.

Syntaxe

typedef struct _GET_CHANGER_PARAMETERS {
  ULONG  Size;
  USHORT NumberTransportElements;
  USHORT NumberStorageElements;
  USHORT NumberCleanerSlots;
  USHORT NumberIEElements;
  USHORT NumberDataTransferElements;
  USHORT NumberOfDoors;
  USHORT FirstSlotNumber;
  USHORT FirstDriveNumber;
  USHORT FirstTransportNumber;
  USHORT FirstIEPortNumber;
  USHORT FirstCleanerSlotAddress;
  USHORT MagazineSize;
  ULONG  DriveCleanTimeout;
  ULONG  Features0;
  ULONG  Features1;
  UCHAR  MoveFromTransport;
  UCHAR  MoveFromSlot;
  UCHAR  MoveFromIePort;
  UCHAR  MoveFromDrive;
  UCHAR  ExchangeFromTransport;
  UCHAR  ExchangeFromSlot;
  UCHAR  ExchangeFromIePort;
  UCHAR  ExchangeFromDrive;
  UCHAR  LockUnlockCapabilities;
  UCHAR  PositionCapabilities;
  UCHAR  Reserved1[2];
  ULONG  Reserved2[2];
} GET_CHANGER_PARAMETERS, *PGET_CHANGER_PARAMETERS;

Membres

Size

Taille de cette structure en octets. Défini sur taille de(GET_CHANGER_PARAMETERS). En effet, ce membre indique la version de cette structure utilisée par le pilote miniclasse.

NumberTransportElements

Indique le nombre d’éléments de transport dans le changeur. Pour un changement SCSI, il est défini dans la page d’adresse de l’élément. Cette valeur est presque toujours 1, car la plupart des changeurs ont un seul élément de transport, qui peut avoir un ou deux mécanismes de sélecteur. Un changement qui a deux mécanismes de sélecteur sur son transport ne doit pas être représenté comme ayant deux transports, car les sélecteurs ne peuvent pas être traités individuellement. Les bibliothèques multimédias haut de gamme peuvent avoir des éléments de transport doubles et multiples pour la tolérance de panne.

NumberStorageElements

Indique le nombre d’éléments de stockage (emplacements) dans le changeur. Pour un changement SCSI, il est défini dans la page d’adresse de l’élément. Cette valeur représente le nombre maximal d’emplacements disponibles pour ce changement, y compris ceux dans les magazines amovibles, si les magazines sont installés. Si NumberCleanerSlots a la valeur 1, NumberStorageElements est inférieur au nombre maximal d’emplacements dans le changeur.

NumberCleanerSlots

Indique le nombre d’éléments de stockage (emplacements) pour les cartouches propres dans le changeur. Pour un changement SCSI, cette valeur n’est pas signalée en mode de données, de sorte que le pilote miniclass doit le fournir. Le pilote miniclass doit définir NumberCleanerSlots à 1 uniquement si le guide de l’opérateur pour le changeur identifie un emplacement spécifique comme emplacement plus propre. Si NumberCleanerSlots est 1, FirstCleanerSlotAddress indique l’adresse de base zéro de l’emplacement dans lequel un nettoyeur de lecteur doit être inséré. Si le changeur ne prend pas en charge le nettoyage des lecteurs en déplaçant par programme la cartouche de nettoyage de son emplacement vers un lecteur, le pilote miniclasse doit définir NumberCleanerSlots à 0. NumberCleanerSlots ne doit pas être supérieur à 1.

NumberIEElements

Indique le nombre d’éléments IEport dont le changeur a pour insérer et éjecter des supports. Pour un changement SCSI, il est défini dans la page d’adresse de l’élément. Un élément IEport ne doit pas faire partie de l’espace d’élément de stockage (emplacement), et il doit être possible de transporter des supports entre iEport et un emplacement à l’aide d’une commande MOVE MEDIUM SCSI. Si le changeur a une porte et non un vrai IEport, le pilote miniclasse doit définir NumberIEElements sur 0.

NumberDataTransferElements

Indique le nombre d’éléments de transfert de données (lecteurs) dans le changeur. Pour un changement SCSI, il est défini dans la page d’adresse de l’élément. Contrairement à NumberStorageElements, qui indique le nombre total d’emplacements possibles si les emplacements sont réellement présents, NumberDataTransferElements indique le nombre de lecteurs réellement présents dans le changeur.

NumberOfDoors

Indique le nombre de portes dont dispose le changeur. Pour un changement SCSI, cette valeur n’est pas signalée en mode de données, de sorte que le pilote miniclass doit le fournir. Une porte permet d’accéder à tous les médias dans le changeur à la fois, contrairement à un IEport qui fournit l’accès à un ou plusieurs médias, mais pas tous. La porte d’un changeur peut être une porte d’entrée physique ou un magazine unique qui contient tous les médias. Si un changeur prend uniquement en charge un IEport pour l’insertion et l’éjection de supports, le NumberOfDoors doit être 0.

FirstSlotNumber

Indique le nombre utilisé par le fournisseur de changement pour identifier le premier élément de stockage (emplacement) du changeur à l’utilisateur final, soit en marquant un magazine, soit en définissant un schéma de numérotation d’emplacement dans le guide des opérateurs du changeur. FirstSlotNumber est généralement 0 ou 1, mais il peut s’agir de la première adresse dans une plage consécutive d’adresses d’emplacement définies par le fournisseur.

FirstDriveNumber

Indique le nombre utilisé par le fournisseur du changeur pour identifier le premier élément de transfert de données (lecteur) dans le changeur à l’utilisateur final. FirstDriveNumber est généralement 0 ou 1, mais il peut s’agir de la première adresse d’une plage consécutive d’adresses de lecteur définies par le fournisseur.

FirstTransportNumber

Indique le nombre utilisé par le fournisseur du changeur pour identifier le premier élément de transport (et généralement uniquement) dans le changeur pour l’utilisateur final. FirstTransportNumber est généralement 0 ou 1, mais il peut s’agir de la première adresse d’une plage consécutive d’adresses de transport définies par le fournisseur.

FirstIEPortNumber

Indique le nombre utilisé par le fournisseur de changement pour identifier le premier (et généralement uniquement) IEport dans le changeur pour l’utilisateur final. FirstIEPortNumber est généralement 0 ou 1, mais il peut s’agir de la première adresse dans une plage consécutive d’adresses IEport définies par le fournisseur. Si NumberIEElements est 0, FirstIEPortNumber doit également être 0.

FirstCleanerSlotAddress

Indique le numéro utilisé par le fournisseur du changeur pour identifier la première adresse d’emplacement (et uniquement) affectée à une cartouche de nettoyage de lecteur à l’utilisateur final. Il doit s’agir de la valeur définie par le fournisseur dans le guide des opérateurs du changeur. Par exemple, si un changement a 8 emplacements numérotés 1 à 8 et que le guide de son opérateur désigne l’emplacement 8 comme emplacement de nettoyage de lecteur, FirstSlotNumber serait 1 et FirstCleanerSlotAddress serait 8. Si les 8 mêmes emplacements étaient numérotés 0 à 7, FirstSlotNumber serait 0 et FirstCleanerSlotAddress serait de 7. Si NumberCleanerSlots est 0, FirstCleanerSlotAddress doit être 0.

MagazineSize

Indique le nombre d’emplacements dans les magazines amovibles dans le changeur. Ce membre est valide uniquement si CHANGER_CARTRIDGE_MAGAZINE est défini dans Features0.

DriveCleanTimeout

Indique deux fois le nombre maximal de secondes qu’un nettoyage doit prendre. Les lecteurs du changeur doivent être nettoyés par sa cartouche propre en deux temps spécifié par DriveCleanTimeout. Par exemple, si un lecteur est généralement nettoyé en 300 secondes (5 minutes), DriveCleanTimeout doit être défini sur 600.

Features0

Indique les fonctionnalités prises en charge par le changeur. Ce membre peut avoir ensemble une ou plusieurs valeurs au niveau du bit ORed au niveau du bit.

CHANGER_BAR_CODE_SCANNER_INSTALLED

Le changeur prend en charge un lecteur de code barre et le lecteur est installé. Un pilote miniclass ne doit pas coder en dur cet indicateur, sauf si le lecteur de code à barres du change est toujours installé. Si le lecteur de code à barres est facultatif, le pilote miniclass doit déterminer si le lecteur est réellement installé et définir l’indicateur en conséquence.

CHANGER_INIT_ELEM_STAT_WITH_RANGE

Le changeur peut initialiser des éléments dans une plage spécifiée. Pour un changement SCSI, cet indicateur indique si le changeur prend en charge la commande INITIALIZE ELEMENT STATUS WITH RANGE SCSI.

CHANGER_CLOSE_IEPORT

Le changeur a un IEport et peut retirer l’IEport par programmation.

CHANGER_OPEN_IEPORT

Le changeur a un IEport et peut étendre l’IEport par programmation.

CHANGER_STATUS_NON_VOLATILE

Le changeur utilise la mémoire nonvolatile pour les informations d’état de l’élément.

CHANGER_EXCHANGE_MEDIA

Prend en charge la commande SCSI EXCHANGE MEDIUM en gérant deux volumes à la fois ou en utilisant d’autres éléments de changement pour émuler cette fonctionnalité.

CHANGER_CLEANER_SLOT

Indique que le changeur a un emplacement spécifique désigné pour une cartouche plus propre. Si cet indicateur est défini, NumberCleanerSlots doit être un et FirstCleanerSlotAddress doit spécifier l’adresse de l’emplacement de nettoyage. Ce bit ne peut être défini que si CHANGER_DRIVE_CLEANING_REQUIRED est défini et CHANGER_CLEANER_OPS_NOT_SUPPORTED est réinitialisé.

CHANGER_LOCK_UNLOCK

La porte du changeur, IEport ou clavier peut être verrouillée ou déverrouillée par programme. Si cet indicateur est défini, LockUnlockCapabilities indique quels éléments peuvent être verrouillés ou déverrouillés.

CHANGER_CARTRIDGE_MAGAZINE

Le changeur utilise des cartouches amovibles pour certains ou tous les emplacements de stockage.

CHANGER_MEDIUM_FLIP

L’élément de transport du changeur prend en charge le support de découpage (rotation). Pour un changement SCSI, cet indicateur reflète le bit de rotation dans la page des paramètres de géométrie de transport.

CHANGER_POSITION_TO_ELEMENT

Le changeur peut positionner le transport vers une destination particulière. Pour un changement SCSI, cet indicateur indique si le changement prend en charge la commande SCSI POSITION TO ELEMENT. Si cet indicateur est défini, PositionCapabilities indique les éléments auxquels le transport peut être positionné.

CHANGER_REPORT_IEPORT_STATE

Le changeur peut signaler si les médias sont présents dans l’IEport. Un tel changement doit avoir un capteur dans l’IEport pour détecter la présence ou l’absence de média.

CHANGER_STORAGE_DRIVE

Le changeur peut utiliser un lecteur en tant qu’élément de stockage indépendant ; autrement dit, il peut stocker des médias dans le lecteur sans le lire. Pour un changement SCSI, cet indicateur reflète l’état du bit DT dans la page des fonctionnalités de l’appareil.

CHANGER_STORAGE_IEPORT

Le changeur peut utiliser un IEport comme élément de stockage indépendant. Pour un changement SCSI, cet indicateur reflète l’état du bit E/E dans la page des fonctionnalités de l’appareil.

CHANGER_STORAGE_SLOT

Le changeur peut utiliser un emplacement comme élément de stockage indépendant pour les supports. Pour un changement SCSI, cet indicateur reflète l’état du bit ST dans la page des fonctionnalités de l’appareil. Les emplacements sont l’emplacement de stockage normal pour les supports. Le changeur doit donc prendre en charge cette fonctionnalité.

CHANGER_STORAGE_TRANSPORT

Le changeur peut utiliser un transport en tant qu’élément de stockage indépendant. Pour un changement SCSI, cet indicateur reflète l’état du bit MT dans la page des fonctionnalités de l’appareil.

CHANGER_DRIVE_CLEANING_REQUIRED

Indique que les lecteurs du changeur peuvent signaler régulièrement des codes de sens qui indiquent que le lecteur nécessite un nettoyage.

CHANGER_PREDISMOUNT_EJECT_REQUIRED

Le changement nécessite une commande explicite émise par le biais d’un pilote de stockage de masse (bande, disque ou CD-ROM, par exemple) pour éjecter un média à partir d’un lecteur avant que le changeur puisse déplacer le média d’un lecteur vers un emplacement. Si le changeur éjecte automatiquement le support, le pilote miniclass doit effacer cet indicateur.

CHANGER_CLEANER_ACCESS_NOT_VALID

L’indicateur ELEMENT_STATUS_ACCESS dans une structure CHANGER_ELEMENT_STATUS pour un élément de transport de données n’est pas valide lorsque l’élément de transport contient une cartouche de nettoyage.

CHANGER_DRIVE_EMPTY_ON_DOOR_ACCESS

Le changement nécessite que tous les lecteurs soient vides (démontés) avant qu’ils ne soient accessibles par la porte. Le pilote miniclass doit définir cet indicateur si le changeur a des lecteurs sensibles statiques susceptibles d’être affectés par un opérateur ayant accès à l’intérieur du changeur, ou si le changeur éjecte automatiquement le média à partir de ses lecteurs lorsque l’opérateur tente d’ouvrir physiquement la porte.

CHANGER_VOLUME_IDENTIFICATION

Le changeur prend en charge l’identification du volume. Pour un changement SCSI, cet indicateur indique si le changeur prend en charge les commandes SCSI SEND VOLUME TAG et REQUEST VOLUME ELEMENT ADDRESS.

CHANGER_VOLUME_SEARCH

Le changeur peut rechercher des informations sur le volume. Pour un changement SCSI, cet indicateur indique si le changeur prend en charge la commande SEND VOLUME TAG SCSI avec un code d’action d’envoi de TRANSLATE.

CHANGER_VOLUME_ASSERT

Le changeur peut vérifier les informations de volume. Pour un changement SCSI, cet indicateur indique si le changeur prend en charge la commande SEND VOLUME TAG SCSI avec un code d’action d’envoi d’ASSERT.

CHANGER_VOLUME_REPLACE

Le changeur peut remplacer les informations de volume. Pour un changement SCSI, cet indicateur indique si le changeur prend en charge la commande SEND VOLUME TAG SCSI avec un code d’action d’envoi de REPLACE.

CHANGER_VOLUME_UNDEFINE

Le changeur peut effacer les informations de volume existantes. Pour un changement SCSI, cet indicateur indique si le changement prend en charge la commande SEND VOLUME TAG SCSI avec un code d’action d’envoi d’UNDEFINE.

CHANGER_SERIAL_NUMBER_VALID

Le numéro de série signalé par GetProductData est valide et unique pour tous les changers de ce type. Les numéros de série ne sont pas garantis d’être uniques entre les gammes de fournisseurs et de produits. Si le numéro de série du change est unique en fonction de cette définition, le pilote miniclasse doit définir cet indicateur et définir SerialNumber dans CHANGER_PRODUCT_DATA sur le numéro de série.

CHANGER_PREMOUNT_EJECT_REQUIRED

Le changement nécessite une commande explicite émise par le biais d’un pilote de stockage de masse pour éjecter un mécanisme de lecteur avant que le changeur puisse déplacer le média d’un emplacement vers le lecteur. Par exemple, un changement avec CD-ROM lecteurs peut nécessiter la présentation du plateau au transport robotisé afin qu’un morceau de média puisse être chargé sur le plateau pendant une opération de montage. Si le changeur éjecte automatiquement le mécanisme, le pilote miniclass doit effacer cet indicateur.

CHANGER_DEVICE_REINITIALIZE_CAPABLE

Le changeur peut recalibrer son élément de transport en réponse à une commande explicite. Le pilote de classe de changement appelle ChangerReinitializeUnit pour lancer la recalibration.

CHANGER_KEYPAD_ENABLE_DISABLE

Le pavé numérique de changement peut être activé et désactivé par programme.

CHANGER_RESERVED_BIT

Réservé pour indiquer les indicateurs de Features1.

Features1

Indique les fonctionnalités supplémentaires prises en charge par le changeur. Ce membre peut avoir ensemble une ou plusieurs valeurs au niveau du bit ORed au niveau du bit.

CHANGER_PREDISMOUNT_ALIGN_TO_SLOT

Indique que le transport doit être déplacé vers l’emplacement de destination avant de déplacer le média d’un lecteur vers l’emplacement. Le bit CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE doit être réinitialisé s’il est défini.

CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE

Indique que le transport doit être déplacé vers le lecteur avant de déplacer le média du lecteur vers un emplacement. Le bit CHANGER_PREDISMOUNT_ALIGN_TO_SLOT doit être réinitialisé s’il est défini.

CHANGER_CLEANER_AUTODISMOUNT

Indique que le changeur déplace automatiquement la cartouche de nettoyage vers son emplacement d’origine, une fois le nettoyage terminé. Ce bit ne peut être défini que si CHANGER_DRIVE_CLEANING_REQUIRED est défini et CHANGER_CLEANER_OPS_NOT_SUPPORTED est réinitialisé.

CHANGER_TRUE_EXCHANGE_CAPABLE

L’appareil peut manipuler deux volumes à la fois sans utiliser d’éléments de changement supplémentaires.

CHANGER_SLOTS_USE_TRAYS

Le changeur utilise des plateaux amovibles dans ses emplacements, ce qui exige que le média soit placé dans un plateau et que le plateau soit déplacé à la position souhaitée.

CHANGER_RTN_MEDIA_TO_ORIGINAL_ADDR

Indique que lors du déplacement du volume d’un lecteur à l’emplacement, le volume doit revenir au même emplacement à partir duquel il a été précédemment déplacé vers le lecteur.

CHANGER_CLEANER_OPS_NOT_SUPPORTED

Indique que le transport du changeur ne peut pas être commandé par programme par logiciel au-dessus du pilote du changeur pour déplacer une cartouche de nettoyage vers un lecteur sale. Ce bit ne peut être défini que si le bit CHANGER_DRIVE_CLEANING_REQUIRED est défini. Si ce bit est défini, CHANGER_CLEANER_AUTODISMOUNT et CHANGER_CLEANER_SLOT doivent être réinitialisés.

CHANGER_IEPORT_USER_CONTROL_OPEN

Le changement exige que l’utilisateur ouvre manuellement un IEport fermé.

CHANGER_IEPORT_USER_CONTROL_CLOSE

Le changement nécessite que l’utilisateur ferme manuellement un IEport ouvert.

CHANGER_MOVE_EXTENDS_IEPORT

Le changeur étend automatiquement la barre d’état chaque fois qu’une commande est émise pour déplacer le média vers un IEport.

CHANGER_MOVE_RETRACTS_IEPORT

Le changeur retire automatiquement la barre d’état chaque fois qu’une commande est émise pour déplacer le média d’un IEport.

MoveFromTransport

Indique si le changeur prend en charge le déplacement d’un élément multimédia d’un élément de transport vers un autre élément de transport, un emplacement de stockage, un IEport ou un lecteur. Pour un changement SCSI, il est défini dans la page des fonctionnalités de l’appareil. Le transport n’est généralement pas la source ou la destination pour le déplacement ou l’échange de supports.

Les appelants peuvent utiliser les masques suivants pour déterminer si le changeur peut déplacer le média vers un élément donné.

CHANGER_TO_TRANSPORT

Le changeur peut effectuer l’opération de l’élément spécifié vers un transport.

CHANGER_TO_SLOT

Le changeur peut effectuer l’opération de l’élément spécifié vers un emplacement de stockage.

CHANGER_TO_IEPORT

Le changeur peut effectuer l’opération de l’élément spécifié vers un IEport.

CHANGER_TO_DRIVE

Le changeur peut effectuer l’opération de l’élément spécifié vers un lecteur.

MoveFromSlot

Indique si le changeur prend en charge le déplacement du support d’un emplacement de stockage vers un élément de transport, un autre emplacement de stockage, un IEport ou un lecteur. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge le déplacement.

MoveFromIePort

Indique si le changeur prend en charge le déplacement d’un support d’un IEport vers un élément de transport, un emplacement de stockage, un autre IEport ou un lecteur. Pour un changement SCSI, il est défini dans la page des fonctionnalités de l’appareil. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge le déplacement

MoveFromDrive

Indique si le changeur prend en charge le déplacement du support d’un lecteur vers un élément de transport, un emplacement de stockage, un IEport ou un autre lecteur. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge le déplacement.

ExchangeFromTransport

Indique si le changeur prend en charge l’échange de support entre un élément de transport et un autre élément de transport, un emplacement de stockage, un IEport ou un lecteur. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge l’échange.

ExchangeFromSlot

Indique si le changeur prend en charge l’échange de support entre un emplacement de stockage et un élément de transport, un autre emplacement de stockage, un IEport ou un lecteur. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge l’échange.

ExchangeFromIePort

Indique si le changeur prend en charge l’échange de support entre un IEport et un élément de transport, un emplacement de stockage, un autre IEport ou un lecteur. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge l’échange.

ExchangeFromDrive

Indique si le changeur prend en charge l’échange de support entre un lecteur et un élément de transport, un emplacement de stockage, un IEport ou un autre lecteur. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge l’échange.

LockUnlockCapabilities

Indique quels éléments d’un changeur peuvent être verrouillés ou déverrouillés par programmation. Ce membre n’est valide que si CHANGER_LOCK_UNLOCK est défini dans Features0.

Les appelants peuvent utiliser les masques suivants pour déterminer si le changeur peut verrouiller ou déverrouiller un élément particulier.

LOCK_UNLOCK_IEPORT

Le changeur peut verrouiller ou déverrouiller son ou ses IEport(s).

LOCK_UNLOCK_DOOR

Le changeur peut verrouiller ou déverrouiller sa porte.

LOCK_UNLOCK_KEYPAD

Le changeur peut verrouiller ou déverrouiller son pavé numérique.

PositionCapabilities

Indique les éléments auxquels un changeur peut positionner son transport. Les appelants peuvent utiliser les masques décrits sous MoveFromTransport pour déterminer si le changeur prend en charge le positionnement du transport sur un élément particulier. Ce membre est valide uniquement si CHANGER_POSITION_TO_ELEMENT est défini dans Features0.

Reserved1[2]

Réservé pour une utilisation ultérieure.

Reserved2[2]