struttura GET_CHANGER_PARAMETERS (winioctl.h)

Rappresenta i parametri di un modificatore.

Sintassi

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;

Members

Size

Dimensioni di questa struttura, in byte. Il chiamante deve impostare questo membro su sizeof(GET_CHANGER_PARAMETERS).

NumberTransportElements

Numero di elementi di trasporto nel modificatore. Per un modificatore SCSI, questo valore viene definito nella pagina dell'indirizzo dell'elemento. Questo valore è quasi sempre 1, perché la maggior parte delle modifiche ha un singolo elemento di trasporto con uno o due meccanismi di selezione. Un cambio che dispone di due meccanismi di selezione nel trasporto non deve essere rappresentato come con due trasporti, perché i picker non sono indirizzabili singolarmente. Le librerie multimediali di fascia alta possono avere elementi di trasporto dual e multipli per la tolleranza di errore.

NumberStorageElements

Numero di elementi di archiviazione (slot) nel modificatore. Per un modificatore SCSI, questo valore viene definito nella pagina dell'indirizzo dell'elemento. Questo valore rappresenta il numero massimo di slot disponibili per questo cambio, inclusi quelli nelle riviste rimovibili, indipendentemente dal fatto che le riviste siano installate. Se NumberCleanerSlots è 1, NumberStorageElements è 1 minore del numero massimo di slot nel modificatore.

NumberCleanerSlots

Numero di elementi di archiviazione (slot) per le munizioni più pulite nel cambio. Se NumberCleanerSlots è 1, FirstCleanerSlotAddress indica l'indirizzo in base zero dello slot in cui deve essere inserito un pulitore di unità. Se il cambio non supporta la pulizia dell'unità spostando a livello di codice la stampante più pulita dallo slot a un'unità, NumberCleanerSlots è 0. NumberCleanerSlots non può essere maggiore di 1.

NumberIEElements

Numero di elementi di importazione/esportazione (porte di inserimento/espulsione) del modificatore per l'inserimento e l'espulsione di supporti. Per un modificatore SCSI, questo valore viene definito nella pagina dell'indirizzo dell'elemento. Un elemento di importazione/esportazione non deve far parte dello spazio dell'elemento di archiviazione (slot) e deve essere possibile trasportare supporti tra l'elemento di importazione/esportazione e uno slot usando un comando MOVE MEDIUM. Se il modificatore ha una porta e non un vero elemento di importazione/esportazione, NumberIEElements è 0.

NumberDataTransferElements

Numero di elementi di trasferimento dei dati (unità) nel modificatore. Per un modificatore SCSI, questo valore viene definito nella pagina dell'indirizzo dell'elemento. A differenza di NumberStorageElements, che indica il numero totale di slot possibili se gli slot sono effettivamente presenti, NumberDataTransferElements indica il numero di unità effettivamente presenti nel modificatore.

NumberOfDoors

Numero di porte nel cambio. Una porta consente l'accesso a tutti i supporti nel modificatore contemporaneamente, a differenza di una porta di inserimento/rimozione, che consente l'accesso a uno o più supporti, ma non a tutti. La porta di un cambiatore può essere una porta principale fisica o una singola rivista che contiene tutti i supporti. Se un modificatore supporta solo una porta di inserimento/espulsione per l'inserimento e l'espulsione di supporti, NumberOfDoors è 0.

FirstSlotNumber

Numero utilizzato dal fornitore del modificatore per identificare il primo elemento di archiviazione (slot) nel modificatore all'utente finale, contrassegnando una rivista o definendo uno schema di numerazione degli slot nella guida degli operatori del modificatore. FirstSlotNumber è in genere 0 o 1, ma può essere il primo indirizzo in un intervallo consecutivo di indirizzi slot definiti dal fornitore.

FirstDriveNumber

Numero utilizzato dal fornitore del modificatore per identificare il primo elemento di trasferimento dati (unità) nel modificatore all'utente finale. FirstDriveNumber è in genere 0 o 1, ma può essere il primo indirizzo in un intervallo consecutivo di indirizzi di unità definiti dal fornitore.

FirstTransportNumber

Numero utilizzato dal fornitore del modificatore per identificare il primo elemento di trasporto (e in genere solo) nel modificatore all'utente finale. FirstTransportNumber è in genere 0 o 1, ma può essere il primo indirizzo in un intervallo consecutivo di indirizzi di trasporto definiti dal fornitore.

FirstIEPortNumber

Numero utilizzato dal fornitore del modificatore per identificare la prima porta (e in genere solo) di inserimento/inserimento nel modificatore all'utente finale. FirstIEPortNumber è in genere 0 o 1, ma può essere il primo indirizzo in un intervallo consecutivo di indirizzi di porta di inserimento/espulsione definiti dal fornitore. Se NumberIEElements è 0, FirstIEPortNumber deve essere 0.

FirstCleanerSlotAddress

Numero utilizzato dal fornitore del modificatore per identificare il primo indirizzo (e solo) dello slot assegnato a una stampante più pulita per l'utente finale. Deve essere il valore definito dal fornitore nella guida degli operatori del modificatore. Ad esempio, se un modificatore ha 8 slot numerati da 1 a 8 e la guida dell'operatore designa lo slot 8 come slot di pulizia dell'unità, FirstSlotNumber sarà 1 e FirstCleanerSlotAddress sarà 8. Se gli stessi 8 slot erano numerati da 0 a 7, FirstSlotNumber sarebbe 0 e FirstCleanerSlotAddress sarebbe 7. Se NumberCleanerSlots è 0, FirstCleanerSlotAddress deve essere 0.

MagazineSize

Numero di slot nelle riviste rimovibili nel cambio. Questo membro è valido solo se CHANGER_CARTRIDGE_MAGAZINE è impostato in Features0.

DriveCleanTimeout

Il doppio del numero massimo di secondi che si prevede di eseguire una pulizia. Le unità del modificatore devono essere pulite dalla sua stampante più pulita nella metà del tempo specificato da DriveCleanTimeout. Ad esempio, se un'unità viene in genere pulita in 300 secondi (5 minuti), DriveCleanTimeout deve essere impostato su 600.

Features0

Funzionalità supportate dal modificatore. Questo membro può essere uno o più dei valori seguenti.

Features1

Eventuali funzionalità aggiuntive supportate dal modificatore. Questo membro può essere uno o più dei valori seguenti.

MoveFromTransport

Indica se il modificatore supporta lo spostamento di un elemento multimediale da un elemento di trasporto a un altro elemento di trasporto, uno slot di archiviazione, una porta di inserimento/rimozione o un'unità. Per un modificatore SCSI, questo valore viene definito nella pagina delle funzionalità del dispositivo. Il trasporto non è in genere l'origine o la destinazione per lo spostamento o lo scambio di supporti.

Per determinare se il modificatore può spostare i supporti in un determinato elemento, usare i valori seguenti.

MoveFromSlot

Indica se il modificatore supporta lo spostamento di un supporto da uno slot di archiviazione a un elemento di trasporto, un altro slot di archiviazione, una porta di inserimento/espulsione o un'unità. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo spostamento.

MoveFromIePort

Indica se il modificatore supporta lo spostamento di un supporto da una porta di inserimento/espulsione a un elemento di trasporto, uno slot di archiviazione, un'altra porta di inserimento/espulsione o un'unità. Per un modificatore SCSI, questo valore viene definito nella pagina delle funzionalità del dispositivo. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo spostamento.

MoveFromDrive

Indica se il modificatore supporta lo spostamento di un supporto da un'unità a un elemento di trasporto, uno slot di archiviazione, una porta di inserimento/espulsione o un'altra unità. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo spostamento.

ExchangeFromTransport

Indica se il modificatore supporta lo scambio di supporto tra un elemento di trasporto e un altro elemento di trasporto, uno slot di archiviazione, una porta di inserimento/espulsione o un'unità. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo scambio.

ExchangeFromSlot

Indica se il modificatore supporta lo scambio di supporto tra uno slot di archiviazione e un elemento di trasporto, un altro slot di archiviazione, una porta di inserimento/espulsione o un'unità. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo scambio.

ExchangeFromIePort

Indica se il modificatore supporta lo scambio di supporto tra una porta di inserimento/espulsione e un elemento di trasporto, uno slot di archiviazione, un'altra porta di inserimento/espulsione o un'unità. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo scambio.

ExchangeFromDrive

Indica se il modificatore supporta lo scambio di supporto tra un'unità e un elemento di trasporto, uno slot di archiviazione, una porta di inserimento/espulsione o un'altra unità. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta lo scambio.

LockUnlockCapabilities

Elementi di un modificatore che possono essere bloccati o sbloccati a livello di codice. Questo membro è valido solo se CHANGER_LOCK_UNLOCK è impostato in Features0.

Per determinare se il modificatore può bloccare o sbloccare un particolare elemento, usare uno o più dei valori seguenti.

PositionCapabilities

Elementi a cui un modificatore può posizionare il trasporto. Usare i flag descritti in MoveFromTransport per determinare se il modificatore supporta il posizionamento del trasporto in un particolare elemento. Questo membro è valido solo se CHANGER_POSITION_TO_ELEMENT è impostato in Features0.

Reserved1[2]

Riservato per usi futuri.

Reserved2[2]

Riservato per usi futuri.

Requisiti

Vedi anche

IOCTL_CHANGER_GET_PARAMETERS