CHANGER_ELEMENT_STATUS_EX struttura (ntddchgr.h)
La routine ChangerGetElementStatus restituisce informazioni sullo stato in questa struttura.
Sintassi
typedef struct _CHANGER_ELEMENT_STATUS_EX {
CHANGER_ELEMENT Element;
CHANGER_ELEMENT SrcElementAddress;
ULONG Flags;
ULONG ExceptionCode;
UCHAR TargetId;
UCHAR Lun;
USHORT Reserved;
UCHAR PrimaryVolumeID[MAX_VOLUME_ID_SIZE];
UCHAR AlternateVolumeID[MAX_VOLUME_ID_SIZE];
UCHAR VendorIdentification[VENDOR_ID_LENGTH];
UCHAR ProductIdentification[PRODUCT_ID_LENGTH];
UCHAR SerialNumber[SERIAL_NUMBER_LENGTH];
} CHANGER_ELEMENT_STATUS_EX, *PCHANGER_ELEMENT_STATUS_EX;
Members
Element
Specifica l'elemento di tipo CHANGER_ELEMENT a cui fa riferimento questa struttura.
SrcElementAddress
Specifica l'elemento di tipo CHANGER_ELEMENT da cui è stato spostato il supporto attualmente in questo elemento. Questo membro è valido solo se ELEMENT_STATUS_SVALID è impostato anche in Flag. Questo valore deve essere un offset in base zero dal valore univoco del dispositivo.
Flags
Indica lo stato dell'elemento, che può essere uno o più dei valori seguenti.
ELEMENT_STATUS_FULL
L'elemento contiene un elemento multimediale. Questo flag è valido se ElementType nel membro Elemento è ChangerDrive, ChangerSlot o ChangerTransport. Se ElementType è ChangerIEPort, questo flag è valido solo se CHANGER_REPORT_IEPORT_STATE è impostato anche in Features0 di GET_CHANGER_PARAMETERS.
ELEMENT_STATUS_IMPEXP
Il supporto in questo elemento è stato inserito da un operatore. Questo flag è valido solo se ElementType nel membro Elemento è ChangerIEPort.
ELEMENT_STATUS_EXCEPT
L'elemento è in uno stato anomalo. Controllare il membro ExceptionCode per altre informazioni.
ELEMENT_STATUS_ACCESS
L'elemento di trasporto del changer può accedere al componente multimediale in questo elemento. Il driver miniclass cancella questo flag per indicare che il supporto non è accessibile per uno dei motivi seguenti: Se ElementType nel membro Elemento è ChangerSlot, lo slot non è presente nel changer (ad esempio, la rivista contenente lo slot è stata rimossa fisicamente). Se ElementType è ChangerDrive, l'unità viene interrotta o rimossa. Se ElementType è ChangerIEPort, L'IEport viene esteso.
ELEMENT_STATUS_EXENAB
L'elemento supporta l'esportazione di supporti tramite IEport del changer.
ELEMENT_STATUS_INENAB
L'elemento supporta l'importazione di supporti tramite IEport del changer.
ELEMENT_STATUS_LUN_VALID
Il numero di dispositivo nel membro Lun è valido. Questo flag è valido solo se ElementType nel membro Element è ChangerDrive.
ELEMENT_STATUS_ID_VALID
L'ID di destinazione SCSI nel membro TargetID è valido. Questo flag è valido solo se ElementType nel membro Element è ChangerDrive.
ELEMENT_STATUS_NOT_BUS
L'unità all'indirizzo indicato da Lun e TargetID è su un bus SCSI diverso rispetto al changer stesso.
ELEMENT_STATUS_PRODUCT_DATA
Il numero di serie nel membro SerialNumber è valido.
ELEMENT_STATUS_INVERT
Il supporto nell'elemento è stato capovolto. Questo flag è valido solo se il flag di ELEMENT_STATUS_SVALID è impostato anche.
ELEMENT_STATUS_SVALID
Il membro SourceElement e il flag di ELEMENT_STATUS_INVERT sono entrambi validi.
ELEMENT_STATUS_PVOLTAG
Le informazioni sul volume primario nel membro PrimaryVolumeID sono valide.
ELEMENT_STATUS_AVOLTAG
Le informazioni del volume alternativo nel membro AlternateVolumeID sono valide.
ExceptionCode
Indica che l'elemento è in uno stato anomalo. Questo membro è valido solo se ELEMENT_STATUS_EXCEPT è impostato in Flag. ExceptionCode può essere impostato su uno dei valori seguenti.
ERROR_LABEL_UNREADABLE
Il lettore di codice della barra 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_LABEL_QUESTIONABLE
L'etichetta potrebbe non essere valida a causa di una condizione di attenzione unità.
ERROR_SLOT_NOT_PRESENT
Lo slot in questo indirizzo di elemento non è attualmente installato nel changer. Un driver miniclass imposta questo codice per ogni slot in una rivista rimovibile per indicare che la rivista è stata rimossa.
ERROR_DRIVE_NOT_INSTALLED
L'unità in questo indirizzo di elemento è assente. Se un modificatore può continuare a funzionare senza l'unità, il driver miniclasse imposta ERROR_DRIVE_NOT_INSTALLED per l'unità.
ERROR_TRAY_MALFUNCTION
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
Condizione di errore sconosciuta.
TargetId
Specifica l'ID di destinazione SCSI dell'unità in questo indirizzo di elemento per un changer SCSI. Questo membro è valido solo se ElementType nel membro Elemento è ChangerDrive e ELEMENT_STATUS_ID_VALID è impostato in Flag.
Lun
Specifica il numero di dispositivo SCSI dell'unità in questo indirizzo di elemento. Questo membro è valido solo se ElementType nel membro Element è ChangerDrive e ELEMENT_STATUS_LUN_VALID è impostato in Flag.
Reserved
Riservato per utilizzi futuri. Il valore di questo membro deve essere zero.
PrimaryVolumeID[MAX_VOLUME_ID_SIZE]
Specifica l'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 in Features0 di GET_CHANGER_PARAMETERS), il driver miniclasse deve impostare PrimaryVolumeID sul codice a barre del supporto. Se il changer non supporta un lettore di codice a barre, il driver miniclasse deve impostare PrimaryVolumeID sul valore assegnato in precedenza al supporto usando la routine ChangerQueryVolumeTags con un'azione ASSERT_PRIMARY o REPLACE_PRIMARY. Questo membro è valido solo se ELEMENT_STATUS_PVOLTAG è impostato anche in Flag. Se l'identificatore del volume manca o non è leggibile, il driver miniclasse deve cancellare questo flag e impostare lo stato di errore appropriato. Questo identificatore non deve essere maggiore di MAX_VOLUME_ID_SIZE byte.
AlternateVolumeID[MAX_VOLUME_ID_SIZE]
Specifica l'identificazione del volume alternativo per i supporti. Questo membro è valido solo per i supporti a due lati e riguarda l'ID del lato invertito. Non rappresenta mai un codice a barre. Il driver miniclasse deve impostare AlternateVolumeID sul valore assegnato in precedenza al supporto usando la routine ChangerQueryVolumeTags con un'azione ASSERT_ALTERNATE o REPLACE_ALTERNATE. L'identificatore non deve essere maggiore di MAX_VOLUME_ID_SIZE byte ed è valido solo se ELEMENT_STATUS_AVOLTAG è impostato anche in Flag.
VendorIdentification[VENDOR_ID_LENGTH]
Contiene l'ID fornitore. Questo identificatore non deve essere maggiore di VENDOR_ID_LENGTH byte.
ProductIdentification[PRODUCT_ID_LENGTH]
Contiene l'ID prodotto. Questo identificatore non deve essere maggiore di PRODUCT_ID_LENGTH byte.
SerialNumber[SERIAL_NUMBER_LENGTH]
Contiene il numero di serie. Questo identificatore non deve essere maggiore di SERIAL_NUMBER_LENGTH byte.
Commenti
La routine ChangerGetElementStatus restituisce informazioni sullo stato in questa struttura se sono necessarie informazioni sul fornitore, sul prodotto o sul numero di serie. In caso contrario , ChangerGetElementStatus restituisce informazioni sullo stato nella struttura CHANGER_ELEMENT_STATUS .
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntddchgr.h |