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 |
|---|---|
|
Der Changer unterstützt einen Barcodeleser, und der Reader ist installiert. |
|
Der Wechselschalter verwendet wechselbare Kassettenmagazine für einige oder alle Speicherplätze. |
|
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. |
|
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. |
|
Der Changer verfügt über einen Einfüge-/Auswurfport und kann den Einfüge-/Auswurfport programmgesteuert zurückziehen. |
|
Der Changer kann sein Transportelement als Reaktion auf einen expliziten Befehl neu kalibrieren. |
|
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. |
|
Der Wechsleer erfordert, dass alle Laufwerke leer (nicht mehr eingebunden) sind, bevor sie über seine Tür auf sie zugegriffen werden können. |
|
Der Changer kann Medien zwischen Elementen austauschen. Bei einem SCSI-Changer gibt dieses Flag an, ob der Changer den EXCHANGE MEDIUM-Befehl unterstützt. |
|
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. |
|
Die Changer-Tastatur kann programmgesteuert aktiviert und deaktiviert werden. |
|
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. |
|
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. |
|
Der Changer verfügt über einen Einfüge-/Auswurfport und kann den Einfüge-/Auswurfport programmgesteuert erweitern. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Die Seriennummer ist gültig und für alle Changer dieses Typs eindeutig. Seriennummern sind nicht garantiert für alle Hersteller und Produktlinien eindeutig. |
|
Der Changer verwendet nicht flüchtigen Speicher für Elementinformationen status. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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.
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.
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.
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) |