CHANGER_ELEMENT_STATUS-Struktur (winioctl.h)

  • Artikel

Stellt die status des angegebenen Elements dar.

Syntax

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;

Member

Element

Eine CHANGER_ELEMENT-Struktur , die das -Element darstellt.

SrcElementAddress

Eine CHANGER_ELEMENT-Struktur , die das Element darstellt, aus dem die Medien, die sich derzeit in diesem Element befinden, zuletzt verschoben wurden.

Dieser Member ist nur gültig, wenn das Flags-Element ELEMENT_STATUS_SVALID enthält.

Flags

Das Element status. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
ELEMENT_STATUS_ACCESS
0x00000008
 Das Transportelement des Changers kann auf das Medienelement in diesem Element zugreifen. Die Medien sind unter folgenden Umständen nicht zugänglich: (1) Wenn der Elementtyp ChangerSlot ist, ist der Slot nicht im Changer vorhanden (z. B. wurde das Magazin, das den Slot enthält, physisch entfernt). (2) Wenn der Elementtyp ChangerDrive ist, ist das Laufwerk beschädigt oder wurde entfernt. (3) Wenn der Elementtyp ChangerIEPort ist, wird der Einfüge-/Auswurfport des Changers erweitert.
ELEMENT_STATUS_AVOLTAG
0x20000000
 Informationen zu alternativen Volumes im AlternateVolumeID-Member sind gültig.
ELEMENT_STATUS_EXCEPT
0x00000004
 Das Element befindet sich in einem abnormalen Zustand. Weitere Informationen finden Sie im Member ExceptionCode .
ELEMENT_STATUS_EXENAB
0x00000010
 Das -Element unterstützt den Export von Medien über den Einfüge-/Auswerfport des Changers.
ELEMENT_STATUS_FULL
0x00000001
 Das Element enthält ein Medienelement.

Beachten Sie, dass dieser Wert nur gültig ist, wenn der Elementtyp ChangerDrive, ChangerSlot oder ChangerTransport ist. Wenn ElementType ChangerIEPort ist, ist dieser Wert nur gültig, wenn das Feature0-Element von GET_CHANGER_PARAMETERS CHANGER_REPORT_IEPORT_STATE enthält.
ELEMENT_STATUS_ID_VALID
0x00002000
 Die SCSI-Ziel-ID im TargetID-Member ist gültig.

Dieser Wert ist nur gültig, wenn der Elementtyp ChangerDrive ist.
ELEMENT_STATUS_IMPEXP
0x00000002
 Die Medien in diesem Element wurden von einem Operator dort platziert.

Dieser Wert ist nur gültig, wenn der Elementtyp ChangerIEPort ist.
ELEMENT_STATUS_INENAB
0x00000020
 Das -Element unterstützt den Import von Medien über den Einfüge-/Auswerfport des Changers.
ELEMENT_STATUS_INVERT
0x00400000
 Die Medien im Element wurden umgedreht.

Dieser Wert ist nur gültig, wenn ELEMENT_STATUS_SVALID ebenfalls enthalten ist.
ELEMENT_STATUS_LUN_VALID
0x00001000
 Die Nummer der logischen Einheit im Lun-Element ist gültig. Dieser Wert ist nur gültig, wenn der Elementtyp ChangerDrive ist.
ELEMENT_STATUS_NOT_BUS
0x00008000
 Das Laufwerk an der von Lun und TargetID angegebenen Adresse befindet sich auf einem anderen SCSI-Bus als der Changer selbst.
ELEMENT_STATUS_PVOLTAG
0x10000000
 Informationen zum primären Volume im PrimaryVolumeID-Member sind gültig.
ELEMENT_STATUS_SVALID
0x00800000
 Das SourceElement-Element und ELEMENT_STATUS_INVERT sind gültig.

ExceptionCode

Ein Ausnahmecode, der angibt, dass sich das Element in einem abnormalen Zustand befindet. Dieser Member ist nur gültig, wenn das Flags-Element ELEMENT_STATUS_EXCEPT enthält. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
ERROR_DRIVE_NOT_INSTALLED
0x00000008
 Das Laufwerk an dieser Elementadresse ist nicht vorhanden.
ERROR_LABEL_QUESTIONABLE
0x00000002
 Die Bezeichnung kann aufgrund einer Unit Attention-Bedingung ungültig sein.
ERROR_LABEL_UNREADABLE
0x00000001
 Der Barcodeleser des Veränderers konnte die Barcodebeschriftung auf dem Medienteil in diesem Element nicht lesen, da das Medium fehlt, beschädigt, unsachgemäß positioniert oder auf dem Kopf steht.
ERROR_SLOT_NOT_PRESENT
0x00000004
 Der Slot an dieser Elementadresse ist derzeit nicht im Changer installiert. Jeder Slot in einem herausnehmbaren Magazin ist nicht vorhanden, um anzugeben, dass das Magazin entfernt wurde.
ERROR_TRAY_MALFUNCTION
0x00000010
 Das Laufwerk an dieser Elementadresse verfügt über ein Fach, das erweitert werden muss, um Medien zu laden oder zu entfernen, und das Fach wird nicht wie erforderlich erweitert.
ERROR_UNHANDLED_ERROR
0xFFFFFFFF
 Unbekannte Fehlerbedingung.

TargetId

Gibt für einen SCSI-Changer die SCSI-Ziel-ID des Laufwerks an dieser Elementadresse an. Dieser Member ist nur gültig, wenn das ElementType-Element der Elementstruktur ChangerDrive ist und das Flags-Element ELEMENT_STATUS_ID_VALID enthält.

Lun

Die SCSI-Nummer der logischen Einheit des Laufwerks an dieser Elementadresse. Dieses Element ist nur gültig, wenn das ElementType-Element der Elementstruktur ChangerDrive ist und das Flags-Element ELEMENT_STATUS_LUN_VALID enthält.

Reserved

Für die zukünftige Verwendung reserviert. Der Wert dieses Members muss 0 sein.

PrimaryVolumeID[MAX_VOLUME_ID_SIZE]

Der Bezeichner des primären Volumes für die Medien. Wenn der Changer einen Barcodeleser unterstützt und der Reader installiert ist (wie durch CHANGER_BAR_CODE_SCANNER_INSTALLED im Feature0-Elementvon GET_CHANGER_PARAMETERS angegeben), ist PrimaryVolumeID der Barcode des Mediums. Wenn der Changer keinen Barcodeleser unterstützt, ist PrimaryVolumeID der Wert, der dem Medium zuvor zugewiesen wurde.

Dieser Member ist nur gültig, wenn das Flags-Element ELEMENT_STATUS_PVOLTAG enthält.

Wenn der Volumebezeichner fehlt oder nicht lesbar ist, wird dieser Member gelöscht.

AlternateVolumeID[MAX_VOLUME_ID_SIZE]

Eine alternative Volumeidentifikation für die Medien. Dieser Member ist nur für zweiseitige Medien gültig und bezieht sich auf die ID der invertierten Seite. Es stellt nie einen Barcode dar.

Dieser Member ist nur gültig, wenn das Flags-Element ELEMENT_STATUS_AVOLTAG enthält.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen

CHANGER_ELEMENT

CHANGER_ELEMENT_STATUS_EX

IOCTL_CHANGER_GET_ELEMENT_STATUS