CHANGER_ELEMENT_STATUS struttura (winioctl.h)

  • Articolo

Rappresenta lo stato dell'elemento specificato.

Sintassi

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;

Members

Element

Struttura CHANGER_ELEMENT che rappresenta l'elemento.

SrcElementAddress

Struttura CHANGER_ELEMENT che rappresenta l'elemento da cui è stato spostato il supporto attualmente in questo elemento.

Questo membro è valido solo se il membro Flags include ELEMENT_STATUS_SVALID.

Flags

Stato dell'elemento. Questo membro può essere uno o più dei valori seguenti.

Valore Significato
ELEMENT_STATUS_ACCESS
0x00000008
 L'elemento di trasporto del changer può accedere al componente multimediale in questo elemento. Il supporto non è accessibile nelle circostanze seguenti: (1) Se il tipo di elemento è ChangerSlot, lo slot non è presente nel changer (ad esempio, la rivista contenente lo slot è stata rimossa fisicamente). (2) Se il tipo di elemento è ChangerDrive, l'unità viene interrotta o rimossa. (3) Se il tipo di elemento è ChangerIEPort, viene estesa la porta di inserimento/rimozione del modificatore.
ELEMENT_STATUS_AVOLTAG
0x20000000
 Le informazioni del volume alternativo nel membro AlternateVolumeID sono valide.
ELEMENT_STATUS_EXCEPT
0x00000004
 L'elemento è in uno stato anomalo. Controllare il membro ExceptionCode per altre informazioni.
ELEMENT_STATUS_EXENAB
0x00000010
 L'elemento supporta l'esportazione di supporti tramite la porta di inserimento/rimozione del modificatore.
ELEMENT_STATUS_FULL
0x00000001
 L'elemento contiene un elemento multimediale.

Si noti che questo valore è valido solo se il tipo di elemento è ChangerDrive, ChangerSlot o ChangerTransport. Se ElementType è ChangerIEPort, questo valore è valido solo se il membro Features0 di GET_CHANGER_PARAMETERS include CHANGER_REPORT_IEPORT_STATE.
ELEMENT_STATUS_ID_VALID
0x00002000
 L'ID di destinazione SCSI nel membro TargetID è valido.

Questo valore è valido solo se il tipo di elemento è ChangerDrive.
ELEMENT_STATUS_IMPEXP
0x00000002
 Il supporto in questo elemento è stato inserito da un operatore.

Questo valore è valido solo se il tipo di elemento è ChangerIEPort.
ELEMENT_STATUS_INENAB
0x00000020
 L'elemento supporta l'importazione di supporti tramite la porta di inserimento/inserimento del modificatore.
ELEMENT_STATUS_INVERT
0x00400000
 Il supporto nell'elemento è stato capovolto.

Questo valore è valido solo se è incluso ELEMENT_STATUS_SVALID.
ELEMENT_STATUS_LUN_VALID
0x00001000
 Il numero di unità logica nel membro Lun è valido. Questo valore è valido solo se il tipo di elemento è ChangerDrive.
ELEMENT_STATUS_NOT_BUS
0x00008000
 L'unità all'indirizzo indicato da Lun e TargetID è su un bus SCSI diverso rispetto al changer stesso.
ELEMENT_STATUS_PVOLTAG
0x10000000
 Le informazioni sul volume primario nel membro PrimaryVolumeID sono valide.
ELEMENT_STATUS_SVALID
0x00800000
 Il membro SourceElement e ELEMENT_STATUS_INVERT sono entrambi validi.

ExceptionCode

Codice di eccezione che indica che l'elemento è in uno stato anomalo. Questo membro è valido solo se il membro Flags include ELEMENT_STATUS_EXCEPT. Questo membro può essere uno dei valori seguenti.

Valore Significato
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 L'unità in questo indirizzo di elemento è assente.
ERROR_LABEL_QUESTIONABLE
0x00000002
 L'etichetta potrebbe non essere valida a causa di una condizione di attenzione unità.
ERROR_LABEL_UNREADABLE
0x00000001
 Il lettore di codice a barre del modificatore non è riuscito a leggere l'etichetta del codice della barra sul componente multimediale in questo elemento, perché il supporto manca, danneggiato, posizionato in modo non corretto o capovolto.
ERROR_SLOT_NOT_PRESENT
0x00000004
 Lo slot in questo indirizzo di elemento non è attualmente installato nel changer. Ogni slot in una rivista rimovibile non è presente per indicare che la rivista è stata rimossa.
ERROR_TRAY_MALFUNCTION
0x00000010
 L'unità in questo indirizzo di elemento ha una barra che deve essere estesa per caricare o rimuovere supporti e la barra non viene estesa come richiesto.
ERROR_UNHANDLED_ERROR
0xffffffff
 Condizione di errore sconosciuta.

TargetId

Per un changer SCSI, specifica l'ID di destinazione SCSI dell'unità in questo indirizzo di elemento. Questo membro è valido solo se il membro ElementType della struttura Element è ChangerDrive e il membro Flags include ELEMENT_STATUS_ID_VALID.

Lun

Numero di unità logica SCSI dell'unità in questo indirizzo dell'elemento. Questo membro è valido solo se il membro ElementType della struttura Element è ChangerDrive e il membro Flags include ELEMENT_STATUS_LUN_VALID.

Reserved

Riservato per utilizzi futuri. Il valore di questo membro deve essere zero.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

Identificatore del volume primario per il supporto. Se il changer supporta un lettore di codice a barre e il lettore viene installato (come indicato da CHANGER_BAR_CODE_SCANNER_INSTALLED nel membro Features0 di GET_CHANGER_PARAMETERS), PrimaryVolumeID è il codice a barre del supporto. Se il changer non supporta un lettore di codice a barre, PrimaryVolumeID è il valore assegnato in precedenza al supporto.

Questo membro è valido solo se il membro Flags include ELEMENT_STATUS_PVOLTAG.

Se l'identificatore del volume manca o non è leggibile, questo membro viene cancellato.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Identificazione del volume alternativo per il supporto. Questo membro è valido solo per i supporti affiancati e riguarda l'ID del lato invertito. Non rappresenta mai un codice a barre.

Questo membro è valido solo se il membro Flags include ELEMENT_STATUS_AVOLTAG.

Requisiti

Requisito Valore
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Intestazione winioctl.h (include Windows.h)

Vedi anche

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS