Freigeben über


GET_CHANGER_PARAMETERS-Struktur (winioctl.h)

Stellt die Parameter eines Changers dar.

Syntax

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

Member

Size

Die Größe dieser Struktur in Bytes. Der Aufrufer muss diesen Member auf sizeof(GET_CHANGER_PARAMETERS)festlegen.

NumberTransportElements

Die Anzahl der Transportelemente im Changer. Für einen SCSI-Changer wird dies auf der Seite "Elementadresse" definiert. Dieser Wert ist fast immer 1, da die meisten Changer über ein einzelnes Transportelement mit einem oder zwei Auswahlmechanismen verfügen. Ein Wechselschalter, der über zwei Auswahlmechanismen für seinen Transport verfügt, darf nicht als zwei Transporte dargestellt werden, da Picker nicht einzeln adressierbar sind. High-End-Medienbibliotheken können aus Gründen der Fehlertoleranz über duale und mehrere Transportelemente verfügen.

NumberStorageElements

Die Anzahl der Speicherelemente (Slots) im Changer. Für einen SCSI-Changer wird dies auf der Seite "Elementadresse" definiert. Dieser Wert stellt die maximale Anzahl von Steckplätzen dar, die für diesen Wechslungsschalter verfügbar sind, einschließlich der Steckplätze in wechselbaren Magazinen, unabhängig davon, ob die Magazine installiert sind oder nicht. Wenn NumberCleanerSlots 1 ist, ist NumberStorageElements 1 kleiner als die maximale Anzahl von Slots im Changer.

NumberCleanerSlots

Die Anzahl der Speicherelemente (Slots) für sauberere Patronen im Wechselschalter. Wenn NumberCleanerSlots den Wert 1 aufweist, gibt FirstCleanerSlotAddress die nullbasierte Adresse des Steckplatzes an, in den ein Laufwerksreiniger eingefügt werden soll. Wenn der Wechselschalter die Laufwerksreinigung durch programmgesteuertes Verschieben der Reinigungspatrone aus dem Steckplatz zu einem Laufwerk nicht unterstützt, ist NumberCleanerSlots 0. NumberCleanerSlots darf nicht größer als 1 sein.

NumberIEElements

Die Anzahl der Import/Export-Elemente (Einfüge-/Auswurfports), über die der Changer zum Einfügen und Auswerfen von Medien verfügt. Für einen SCSI-Changer wird dies auf der Seite "Elementadresse" definiert. Ein Import/Export-Element darf nicht Teil des Speicherelementbereichs (Slot) sein, und es muss möglich sein, Medien mit einem MOVE MEDIUM-Befehl zwischen dem Import/Export-Element und einem Slot zu transportieren. Wenn der Changer über eine Tür und kein echtes Import/Export-Element verfügt, ist NumberIEElements 0.

NumberDataTransferElements

Die Anzahl der Datenübertragungselemente (Laufwerke) im Changer. Für einen SCSI-Changer wird dies auf der Seite "Elementadresse" definiert. Im Gegensatz zu NumberStorageElements, das die Gesamtzahl der möglichen Slots angibt, unabhängig davon, ob die Slots tatsächlich vorhanden sind oder nicht, gibt NumberDataTransferElements die Anzahl der Laufwerke an, die tatsächlich im Changer vorhanden sind.

NumberOfDoors

Die Anzahl der Türen im Wechselschalter. Eine Tür bietet zugriff auf alle Medien im Wechsleschalter gleichzeitig, im Gegensatz zu einem Ein-/Auswurfanschluss, der Zugriff auf ein oder mehrere, aber nicht alle Medien ermöglicht. Eine Wechseltür kann eine physische Eingangstür oder ein einzelnes Magazin sein, das alle Medien enthält. Wenn ein Changer nur einen Einfüge-/Auswerfport zum Einfügen und Auswerfen von Medien unterstützt, ist NumberOfDoors 0.

FirstSlotNumber

Die Zahl, die vom Changeranbieter verwendet wird, um das erste Speicherelement (Slot) im Changer für den Endbenutzer zu identifizieren, entweder durch Markieren eines Magazins oder durch Definieren eines Slotnummerierungsschemas im Operatorenleitfaden des Changers. FirstSlotNumber ist in der Regel 0 oder 1, kann jedoch die erste Adresse in einem aufeinanderfolgenden Bereich von Slotadressen sein, der vom Anbieter definiert wird.

FirstDriveNumber

Die Nummer, die vom Changerhersteller verwendet wird, um das erste Datenübertragungselement (Laufwerk) im Changer an den Endbenutzer zu identifizieren. FirstDriveNumber ist in der Regel 0 oder 1, aber es kann die erste Adresse in einem aufeinanderfolgenden Bereich von Laufwerksadressen sein, die vom Anbieter definiert werden.

FirstTransportNumber

Die Nummer, die vom Changeranbieter verwendet wird, um das erste (und in der Regel einzige) Transportelement im Changer an den Endbenutzer zu identifizieren. FirstTransportNumber ist in der Regel 0 oder 1, kann aber die erste Adresse in einem aufeinanderfolgenden, vom Anbieter definierten Bereich von Transportadressen sein.

FirstIEPortNumber

Die Nummer, die vom Changerhersteller verwendet wird, um den ersten (und in der Regel nur) Einfüge-/Auswurfport im Changer an den Endbenutzer zu identifizieren. FirstIEPortNumber ist in der Regel 0 oder 1, aber es kann die erste Adresse in einem aufeinanderfolgenden Bereich von Einfüge-/Auswerfportadressen sein, die vom Anbieter definiert werden. Wenn NumberIEElements den Wert 0 aufweist, muss FirstIEPortNumber ebenfalls 0 sein.

FirstCleanerSlotAddress

Die Nummer, die vom Changerhersteller verwendet wird, um die erste (und einzige) Slotadresse zu identifizieren, die dem Endbenutzer einer Laufwerksreinigerpatrone zugewiesen ist. Dies muss der Wert sein, der vom Anbieter in der Operatorenhinweisliste des Changers definiert wird. Wenn z. B. ein Changer über 8 Steckplätze verfügt, die 1 bis 8 nummeriert sind und die Operatorführung Slot 8 als Laufwerksbereinigungssteckplatz festlegt, wäre FirstSlotNumber 1 und FirstCleanerSlotAddress wäre 8. Wenn dieselben 8 Slots mit 0 bis 7 nummeriert würden, wäre FirstSlotNumber 0 und FirstCleanerSlotAddress wäre 7. Wenn NumberCleanerSlots den Wert 0 aufweist, muss FirstCleanerSlotAddress 0 sein.

MagazineSize

Die Anzahl der Steckplätze in den wechselbaren Magazinen im Wechselschalter. Dieser Member ist nur gültig, wenn CHANGER_CARTRIDGE_MAGAZINE in Features0 festgelegt ist.

DriveCleanTimeout

Doppelt so viel wie die maximale Anzahl von Sekunden, die eine Reinigung in Anspruch nehmen soll. Die Laufwerke des Wechselschalters sollten in der Hälfte der durch DriveCleanTimeout angegebenen Zeit von seiner sauberen Patrone bereinigt werden. Wenn ein Laufwerk beispielsweise in der Regel in 300 Sekunden (5 Minuten) bereinigt wird, sollte DriveCleanTimeout auf 600 festgelegt werden.

Features0

Die vom Changer unterstützten Features. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
CHANGER_BAR_CODE_SCANNER_INSTALLED
0x00000001
Der Changer unterstützt einen Barcodeleser, und der Reader ist installiert.
CHANGER_CARTRIDGE_MAGAZINE
0x00000100
Der Wechselschalter verwendet wechselbare Kassettenmagazine für einige oder alle Speicherplätze.
CHANGER_CLEANER_ACCESS_NOT_VALID
0x00040000
Das ELEMENT_STATUS_ACCESS-Flag in einer CHANGER_ELEMENT_STATUS-Struktur für ein Datentransportelement ist ungültig, wenn das Transportelement eine Reinigungspatrone enthält.
CHANGER_CLEANER_SLOT
0x00000040
Der Wechselschalter verfügt über einen Steckplatz, der für eine sauberere Patrone vorgesehen ist. Wenn dieses Flag festgelegt ist, muss NumberCleanerSlots 1 und FirstCleanerSlotAddress die Adresse des saubereren Slots angeben.
CHANGER_CLOSE_IEPORT
0x00000004
Der Changer verfügt über einen Einfüge-/Auswurfport und kann den Einfüge-/Auswurfport programmgesteuert zurückziehen.
CHANGER_DEVICE_REINITIALIZE_CAPABLE
0x08000000
Der Changer kann sein Transportelement als Reaktion auf einen expliziten Befehl neu kalibrieren.
CHANGER_DRIVE_CLEANING_REQUIRED
0x00010000
Die Laufwerke des Wechselschalters erfordern eine regelmäßige Reinigung, die entweder vom Benutzer oder einer Anwendung initiiert werden muss, und der Wechser kann sein Transportelement verwenden, um eine sauberere Patrone in einem Laufwerk zu montieren.
CHANGER_DRIVE_EMPTY_ON_DOOR_ACCESS
0x20000000
Der Wechsleer erfordert, dass alle Laufwerke leer (nicht mehr eingebunden) sind, bevor sie über seine Tür auf sie zugegriffen werden können.
CHANGER_EXCHANGE_MEDIA
0x00000020
Der Changer kann Medien zwischen Elementen austauschen. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer den EXCHANGE MEDIUM-Befehl unterstützt.
CHANGER_INIT_ELEM_STAT_WITH_RANGE
0x00000002
Der Changer kann Elemente innerhalb eines angegebenen Bereichs initialisieren. Für einen SCSI-Changer gibt dieses Flag an, ob der Changer den Befehl INITIALIZE ELEMENT STATUS WITH RANGE unterstützt.
CHANGER_KEYPAD_ENABLE_DISABLE
0x10000000
Die Changer-Tastatur kann programmgesteuert aktiviert und deaktiviert werden.
CHANGER_LOCK_UNLOCK
0x00000080
Die Wechseltür, der Ein-/Auswurfanschluss oder die Tastatur können programmgesteuert gesperrt oder entsperrt werden. Wenn dieses Flag festgelegt ist, gibt LockUnlockCapabilities an, welche Elemente gesperrt oder entsperrt werden können.
CHANGER_MEDIUM_FLIP
0x00000200
Das Transportelement des Changers unterstützt flippende (drehende) Medien. Bei einem SCSI-Changer spiegelt dieses Flag das Drehbit auf der Seite mit den Parametern für die Transportgeometrie wider.
CHANGER_OPEN_IEPORT
0x00000008
Der Changer verfügt über einen Einfüge-/Auswurfport und kann den Einfüge-/Auswurfport programmgesteuert erweitern.
CHANGER_POSITION_TO_ELEMENT
0x00000400
Der Changer kann den Transport an ein bestimmtes Ziel positionieren. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer den BEFEHL POSITION TO ELEMENT unterstützt. Wenn dieses Flag festgelegt ist, gibt PositionCapabilities die Elemente an, auf denen der Transport positioniert werden kann.
CHANGER_PREDISMOUNT_EJECT_REQUIRED
0x00020000
Der Changer erfordert einen expliziten Befehl, der über einen Massenspeichertreiber (z. B. Band, Datenträger oder CDROM) ausgegeben wird, um Medien aus einem Laufwerk auszuwerfen, bevor der Changer die Medien von einem Laufwerk in einen Steckplatz verschieben kann.
CHANGER_PREMOUNT_EJECT_REQUIRED
0x00080000
Der Changer erfordert einen expliziten Befehl, der über einen Massenspeichertreiber ausgegeben wird, um einen Laufwerksmechanismus auszuwerfen, bevor der Changer Medien von einem Steckplatz auf das Laufwerk verschieben kann. Beispielsweise kann es für einen Wechselschalter mit CD-ROM-Laufwerken erforderlich sein, dass das Fach dem Robotertransport angezeigt wird, damit während eines Montagevorgangs ein Medienteil auf das Fach geladen werden kann.
CHANGER_REPORT_IEPORT_STATE
0x00000800
Der Changer kann melden, ob Medien im Einfüge-/Auswerfport vorhanden sind. Ein solcher Changer muss über einen Sensor im Einfüge-/Auswurfanschluss verfügen, um das Vorhandensein oder Fehlen von Medien zu erkennen.
CHANGER_SERIAL_NUMBER_VALID
0x04000000
Die Seriennummer ist gültig und für alle Changer dieses Typs eindeutig. Seriennummern sind nicht garantiert für alle Hersteller und Produktlinien eindeutig.
CHANGER_STATUS_NON_VOLATILE
0x00000010
Der Changer verwendet nicht flüchtigen Speicher für Elementinformationen status.
CHANGER_STORAGE_DRIVE
0x00001000
Der Changer kann ein Laufwerk als unabhängiges Speicherelement verwenden. Das heißt, es kann Medien auf dem Laufwerk speichern, ohne es zu lesen. Bei einem SCSI-Changer gibt dieses Flag den Status des DT-Bits auf der Seite mit den Gerätefunktionen an.
CHANGER_STORAGE_IEPORT
0x00002000
Der Changer kann einen Einfüge-/Auswurfport als unabhängiges Speicherelement verwenden. Bei einem SCSI-Changer gibt dieses Flag den Status des E/E-Bits auf der Seite mit den Gerätefunktionen an.
CHANGER_STORAGE_SLOT
0x00004000
Der Changer kann einen Slot als unabhängiges Speicherelement für Medien verwenden. Bei einem SCSI-Changer spiegelt dieses Flag den Status des ST-Bits auf der Seite mit den Gerätefunktionen wider. Slots sind der normale Speicherort für Medien, daher muss der Changer diese Funktionalität unterstützen.
CHANGER_STORAGE_TRANSPORT
0x00008000
Der Changer kann einen Transport als unabhängiges Speicherelement verwenden. Bei einem SCSI-Changer gibt dieses Flag den Status des MT-Bits auf der Seite mit den Gerätefunktionen an.
CHANGER_VOLUME_ASSERT
0x00400000
Der Changer kann Volumeinformationen überprüfen. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer den Befehl SEND VOLUME TAG mit dem Sendeaktionscode ASSERT unterstützt.
CHANGER_VOLUME_IDENTIFICATION
0x00100000
Der Changer unterstützt die Volumeidentifikation. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer die Befehle SEND VOLUME TAG und REQUEST VOLUME ELEMENT ADDRESS unterstützt.
CHANGER_VOLUME_REPLACE
0x00800000
Der Changer kann Volumeinformationen ersetzen. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer den Befehl SEND VOLUME TAG mit dem Sendeaktionscode REPLACE unterstützt.
CHANGER_VOLUME_SEARCH
0x00200000
Der Changer kann nach Volumeinformationen suchen. Für einen SCSI-Changer gibt dieses Flag an, ob der Changer den Befehl SEND VOLUME TAG mit dem Sendeaktionscode TRANSLATE unterstützt.
CHANGER_VOLUME_UNDEFINE
0x01000000
Der Changer kann vorhandene Volumeinformationen löschen. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer den Befehl SEND VOLUME TAG mit dem Sendeaktionscode UNDEFINE unterstützt.

Features1

Alle zusätzlichen Features, die vom Changer unterstützt werden. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
CHANGER_CLEANER_AUTODISMOUNT
0x80000004
Der Wechselschalter verschenkt die Reinigungspatrone nach Abschluss der Reinigung automatisch wieder in den ursprünglichen Slot.
CHANGER_CLEANER_OPS_NOT_SUPPORTED
0x80000040
Der Wechselschalter unterstützt keine automatische Reinigung seiner Elemente.
CHANGER_IEPORT_USER_CONTROL_CLOSE
0x80000100
Der Changer erfordert, dass der Benutzer einen geöffneten Einfüge-/Auswurfport manuell schließt.
CHANGER_IEPORT_USER_CONTROL_OPEN
0x80000080
Der Changer erfordert, dass der Benutzer einen geschlossenen Einfüge-/Auswurfport manuell öffnet.
CHANGER_MOVE_EXTENDS_IEPORT
0x80000200
Der Wechselschalter erweitert das Fach automatisch, wenn ein Befehl ausgegeben wird, um Medien an einen Einfüge-/Auswerfport zu verschieben.
CHANGER_MOVE_RETRACTS_IEPORT
0x80000400
Der Wechselschalter zieht das Fach automatisch zurück, wenn ein Befehl zum Verschieben von Medien aus einem Einfüge-/Auswurfport ausgegeben wird.
CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE
0x80000002
Der Changer erfordert einen expliziten Befehl, um das Transportelement auf einem Laufwerk zu positionieren, bevor es Medien aus dem Laufwerk auswerfen kann.
CHANGER_PREDISMOUNT_ALIGN_TO_SLOT
0x80000001
Der Changer erfordert einen expliziten Befehl, um das Transportelement in einem Slot zu positionieren, bevor es Medien aus dem Slot auswerfen kann.
CHANGER_RTN_MEDIA_TO_ORIGINAL_ADDR
0x80000020
Der Changer erfordert, dass Medien nach dem Verschieben in den ursprünglichen Slot zurückgegeben werden.
CHANGER_SLOTS_USE_TRAYS
0x80000010
Der Wechslungsschalter verwendet wechselbare Trays in seinen Schlitzen, die erfordern, dass die Medien in einem Fach platziert werden und das Fach in die gewünschte Position verschoben wird.
CHANGER_TRUE_EXCHANGE_CAPABLE
0x80000008
Der Changer kann Medien zwischen einer Quelle und einem Ziel in einem einzigen Vorgang austauschen. Dieses Flag ist nur gültig, wenn CHANGER_EXCHANGE_MEDIA auch in Features0 festgelegt ist.

MoveFromTransport

Gibt an, ob der Changer das Verschieben eines Medienteils von einem Transportelement in ein anderes Transportelement, einen Speicherslot, einen Ein-/Auswurfport oder ein Laufwerk unterstützt. Für einen SCSI-Changer ist dies auf der Seite "Gerätefunktionen" definiert. Der Transport ist in der Regel nicht die Quelle oder das Ziel für das Verschieben oder Austauschen von Medien.

Verwenden Sie die folgenden Werte, um zu bestimmen, ob der Changer Medien in ein bestimmtes Element verschieben kann.

Wert Bedeutung
CHANGER_TO_DRIVE
0x08
Der Changer kann den Vorgang vom angegebenen Element auf ein Laufwerk ausführen.
CHANGER_TO_IEPORT
0x04
Der Changer kann den Vorgang vom angegebenen Element an einen Einfüge-/Auswurfport ausführen.
CHANGER_TO_SLOT
0x02
Der Changer kann den Vorgang vom angegebenen Element in einen Speicherslot ausführen.
CHANGER_TO_TRANSPORT
0x01
Der Changer kann den Vorgang vom angegebenen Element zu einem Transport ausführen.

MoveFromSlot

Gibt an, ob der Changer das Verschieben eines Mediums von einem Speicherslot zu einem Transportelement, einem anderen Speicherslot, einem Ein-/Auswurfport oder einem Laufwerk unterstützt. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer die Verschiebung unterstützt.

MoveFromIePort

Gibt an, ob der Changer das Verschieben des Mediums von einem Ein-/Auswurfport zu einem Transportelement, einem Speicherslot, einem anderen Ein-/Auswurfport oder einem Laufwerk unterstützt. Für einen SCSI-Changer ist dies auf der Seite "Gerätefunktionen" definiert. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer die Verschiebung unterstützt.

MoveFromDrive

Gibt an, ob der Changer das Verschieben eines Mediums von einem Laufwerk zu einem Transportelement, einem Speicherslot, einem Ein-/Auswurfport oder einem anderen Laufwerk unterstützt. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer die Verschiebung unterstützt.

ExchangeFromTransport

Gibt an, ob der Changer den Austausch zwischen einem Transportelement und einem anderen Transportelement, einem Speicherslot, einem Ein-/Auswurfport oder einem Laufwerk unterstützt. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer den Austausch unterstützt.

ExchangeFromSlot

Gibt an, ob der Changer den Austausch zwischen einem Speicherslot und einem Transportelement, einem anderen Speicherslot, einem Ein-/Auswurfport oder einem Laufwerk unterstützt. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer den Austausch unterstützt.

ExchangeFromIePort

Gibt an, ob der Changer den Austausch zwischen einem Einfüge-/Auswurfport und einem Transportelement, einem Speicherslot, einem anderen Einfüge-/Auswurfport oder einem Laufwerk unterstützt. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer den Austausch unterstützt.

ExchangeFromDrive

Gibt an, ob der Changer den Austausch zwischen einem Laufwerk und einem Transportelement, einem Speicherslot, einem Ein-/Auswurfport oder einem anderen Laufwerk unterstützt. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Changer den Austausch unterstützt.

LockUnlockCapabilities

Die Elemente eines Changers, die programmgesteuert gesperrt oder entsperrt werden können. Dieser Member ist nur gültig, wenn CHANGER_LOCK_UNLOCK in Features0 festgelegt ist.

Verwenden Sie einen oder mehrere der folgenden Werte, um zu bestimmen, ob der Changer ein bestimmtes Element sperren oder entsperren kann.

Wert Bedeutung
LOCK_UNLOCK_DOOR
0x02
Der Veränderer kann seine Tür sperren oder entsperren.
LOCK_UNLOCK_IEPORT
0x01
Der Changer kann seinen Ein-/Auswurfport sperren oder entsperren.
LOCK_UNLOCK_KEYPAD
0x04
Der Changer kann seine Tastatur sperren oder entsperren.

PositionCapabilities

Die Elemente, auf denen ein Wechser seinen Transport positionieren kann. Verwenden Sie die unter MoveFromTransport beschriebenen Flags, um zu bestimmen, ob der Wechsleer die Positionierung des Transports zu einem bestimmten Element unterstützt. Dieser Member ist nur gültig, wenn CHANGER_POSITION_TO_ELEMENT in Features0 festgelegt ist.

Reserved1[2]

Für zukünftige Verwendung reserviert.

Reserved2[2]

Für die zukünftige Verwendung reserviert.

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

IOCTL_CHANGER_GET_PARAMETERS