Partager via

structure CHANGER_ELEMENT_STATUS (winioctl.h)

  • Article

Représente la status de l’élément spécifié.

Syntaxe

typedef struct _CHANGER_ELEMENT_STATUS {
  CHANGER_ELEMENT Element;
  CHANGER_ELEMENT SrcElementAddress;
  DWORD           Flags;
  DWORD           ExceptionCode;
  BYTE            TargetId;
  BYTE            Lun;
  WORD            Reserved;
  BYTE            PrimaryVolumeID[MAX_VOLUME_ID_SIZE];
  BYTE            AlternateVolumeID[MAX_VOLUME_ID_SIZE];
} CHANGER_ELEMENT_STATUS, *PCHANGER_ELEMENT_STATUS;

Membres

Element

Structure CHANGER_ELEMENT qui représente l’élément.

SrcElementAddress

Une structure CHANGER_ELEMENT qui représente l’élément à partir duquel le média actuellement présent dans cet élément a été déplacé récemment.

Ce membre n’est valide que si le membre Flags inclut ELEMENT_STATUS_SVALID.

Flags

L’élément status. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
ELEMENT_STATUS_ACCESS
0x00000008
 L’élément de transport du changeur peut accéder à la partie du média dans cet élément. Le média n’est pas accessible dans les circonstances suivantes : (1) Si le type d’élément est ChangerSlot, l’emplacement n’est pas présent dans le changeur (par exemple, le magazine contenant l’emplacement a été physiquement supprimé). (2) Si le type d’élément est ChangerDrive, le lecteur est défectueux ou a été supprimé. (3) Si le type d’élément est ChangerIEPort, le port d’insertion/d’éjection du changeur est étendu.
ELEMENT_STATUS_AVOLTAG
0x20000000
 Les informations de volume de remplacement dans le membre AlternateVolumeID sont valides.
ELEMENT_STATUS_EXCEPT
0x00000004
 L’élément est dans un état anormal. Pour plus d’informations, consultez le membre ExceptionCode .
ELEMENT_STATUS_EXENAB
0x00000010
 L’élément prend en charge l’exportation de média via le port d’insertion/d’éjection du changeur.
ELEMENT_STATUS_FULL
0x00000001
 L’élément contient un élément multimédia.

Notez que cette valeur est valide uniquement si le type d’élément est ChangerDrive, ChangerSlot ou ChangerTransport. Si ElementType est ChangerIEPort, cette valeur n’est valide que si le membre Features0 de GET_CHANGER_PARAMETERS inclut CHANGER_REPORT_IEPORT_STATE.
ELEMENT_STATUS_ID_VALID
0x00002000
 L’ID cible SCSI dans le membre TargetID est valide.

Cette valeur est valide uniquement si le type d’élément est ChangerDrive.
ELEMENT_STATUS_IMPEXP
0x00000002
 Le média de cet élément y a été placé par un opérateur.

Cette valeur est valide uniquement si le type d’élément est ChangerIEPort.
ELEMENT_STATUS_INENAB
0x00000020
 L’élément prend en charge l’importation de média via le port d’insertion/d’éjection du changeur.
ELEMENT_STATUS_INVERT
0x00400000
 Le média de l’élément a été retourné.

Cette valeur n’est valide que si ELEMENT_STATUS_SVALID est également inclus.
ELEMENT_STATUS_LUN_VALID
0x00001000
 Le numéro d’unité logique dans le membre Lun est valide. Cette valeur est valide uniquement si le type d’élément est ChangerDrive.
ELEMENT_STATUS_NOT_BUS
0x00008000
 Le lecteur à l’adresse indiquée par Lun et TargetID se trouve sur un bus SCSI différent de celui du changeur lui-même.
ELEMENT_STATUS_PVOLTAG
0x10000000
 Les informations de volume principal dans le membre PrimaryVolumeID sont valides.
ELEMENT_STATUS_SVALID
0x00800000
 Le membre SourceElement et ELEMENT_STATUS_INVERT sont tous deux valides.

ExceptionCode

Code d’exception qui indique que l’élément est dans un état anormal. Ce membre est valide uniquement si le membre Flags inclut ELEMENT_STATUS_EXCEPT. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 Le lecteur à cette adresse d’élément est absent.
ERROR_LABEL_QUESTIONABLE
0x00000002
 L’étiquette peut être non valide en raison d’une condition d’attention unitaire.
ERROR_LABEL_UNREADABLE
0x00000001
 Le lecteur de codes-barres du changeur n’a pas pu lire l’étiquette de code à barres sur le support de cet élément, car le média est manquant, endommagé, mal positionné ou à l’envers.
ERROR_SLOT_NOT_PRESENT
0x00000004
 L’emplacement à cette adresse d’élément n’est actuellement pas installé dans le changeur. Chaque emplacement d’un magasin amovible n’est pas présent pour indiquer que le magazine a été supprimé.
ERROR_TRAY_MALFUNCTION
0x00000010
 Le lecteur à cette adresse d’élément a une barre d’état qui doit être étendue pour charger ou supprimer le support, et la barre d’état ne s’étend pas comme nécessaire.
ERROR_UNHANDLED_ERROR
0xFFFFFFFF
 Condition d’erreur inconnue.

TargetId

Pour un changeur SCSI, spécifie l’ID cible SCSI du lecteur à l’adresse de cet élément. Ce membre n’est valide que si le membre ElementType de la structure Element est ChangerDrive et que le membre Flags inclut ELEMENT_STATUS_ID_VALID.

Lun

Numéro d’unité logique SCSI du lecteur à l’adresse de cet élément. Ce membre est valide uniquement si le membre ElementType de la structure Element est ChangerDrive et si le membre Flags inclut ELEMENT_STATUS_LUN_VALID.

Reserved

Réservé pour un usage futur. La valeur de ce membre doit être égale à zéro.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

Identificateur de volume principal pour le média. Si le changeur prend en charge un lecteur de codes-barres et que le lecteur est installé (comme indiqué par CHANGER_BAR_CODE_SCANNER_INSTALLED dans le membre Features0 de GET_CHANGER_PARAMETERS), PrimaryVolumeID est le code à barres du média. Si le changeur ne prend pas en charge un lecteur de codes-barres, PrimaryVolumeID est la valeur précédemment affectée au média.

Ce membre est valide uniquement si le membre Flags inclut ELEMENT_STATUS_PVOLTAG.

Si l’identificateur de volume est manquant ou illisible, ce membre est effacé.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Autre identification de volume pour le média. Ce membre n’est valide que pour les médias à deux faces et se rapporte à l’ID du côté inversé. Il ne représente jamais un code-barres.

Ce membre est valide uniquement si le membre Flags inclut ELEMENT_STATUS_AVOLTAG.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
En-tête winioctl.h (inclure Windows.h)

Voir aussi

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS