TAPE_INIT_DATA_EX struttura (minitape.h)

Articolo
02/26/2024

TAPE_INIT_DATA_EX definisce valori e routine specifiche di un driver miniclasse nastro windows 2000. La routine miniclasse DriverEntry del nastro passa queste informazioni al driver della classe nastro per completare l'inizializzazione del driver miniclasse.

Sintassi

typedef struct _TAPE_INIT_DATA_EX {
  ULONG                        InitDataSize;
  TAPE_VERIFY_INQUIRY_ROUTINE  VerifyInquiry;
  BOOLEAN                      QueryModeCapabilitiesPage;
  ULONG                        MinitapeExtensionSize;
  TAPE_EXTENSION_INIT_ROUTINE  ExtensionInit;
  ULONG                        DefaultTimeOutValue;
  TAPE_ERROR_ROUTINE           TapeError;
  ULONG                        CommandExtensionSize;
  TAPE_PROCESS_COMMAND_ROUTINE CreatePartition;
  TAPE_PROCESS_COMMAND_ROUTINE Erase;
  TAPE_PROCESS_COMMAND_ROUTINE GetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE GetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE GetStatus;
  TAPE_PROCESS_COMMAND_ROUTINE Prepare;
  TAPE_PROCESS_COMMAND_ROUTINE SetDriveParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetMediaParameters;
  TAPE_PROCESS_COMMAND_ROUTINE SetPosition;
  TAPE_PROCESS_COMMAND_ROUTINE WriteMarks;
  TAPE_PROCESS_COMMAND_ROUTINE PreProcessReadWrite;
  TAPE_PROCESS_COMMAND_ROUTINE TapeGetMediaTypes;
  ULONG                        MediaTypesSupported;
  TAPE_PROCESS_COMMAND_ROUTINE TapeWMIOperations;
  ULONG                        Reserved[2];
} TAPE_INIT_DATA_EX, *PTAPE_INIT_DATA_EX;

Members

InitDataSize

Dimensioni di questa struttura, in byte.

VerifyInquiry

Specifica il punto di ingresso della routine nastro miniclasse TapeMiniVerifyI query , che determina se il driver supporta un determinato dispositivo. Questa routine è necessaria.

QueryModeCapabilitiesPage

Indirizza il driver della classe nastro quando TRUE passa una pagina delle funzionalità della modalità alle routine TapeMiniVerifyInquiry e TapeMiniExtensionInit del driver nastro.

MinitapeExtensionSize

Specifica le dimensioni, in byte, di un'area di contesto specifica del driver. Se questo membro è diverso da zero, ExtensionInit non deve essere NULL. Questo valore è facoltativo e deve essere impostato su zero se non usato.

ExtensionInit

Puntatore alla routine tape miniclass driver TapeMiniExtensionInit , che inizializza un'estensione minitape facoltativa, se presente. Se MiniTapeExtensionSize è zero, ExtensionInit deve essere NULL.

DefaultTimeOutValue

Specifica il numero di secondi in cui il driver della classe nastro attende una richiesta SRB prima di annullarla. Se questo valore è zero, il driver della classe nastro imposta un valore predefinito appropriato. Il driver della classe nastro usa sempre il valore di timeout predefinito per le richieste di lettura e scrittura. Le routine contenute nella struttura TAPE_INIT_DATA_EX possono eseguire l'override del valore di timeout predefinito per le richieste di controllo del dispositivo impostando TimeOutValue in una SRB.

TapeError

Puntatore alla routine TapeMiniTapeError del driver di nastro miniclasse, che aumenta le attività di gestione degli errori del driver della classe nastro. Questa routine è facoltativa. Se non viene usato, TapeError deve essere impostato su NULL.

CommandExtensionSize

Specifica le dimensioni, in byte, di un'estensione di comando da allocare prima dell'inizio di ogni comando nastro. Un driver di miniclasse nastro usa l'estensione del comando per archiviare il contesto durante l'elaborazione dei comandi nastro. Le dimensioni e la struttura interna sono definite dal driver miniclasse nastro. Un'estensione del comando è facoltativa. Se non viene usato, CommandExtensionSize deve essere impostato su zero.

CreatePartition

Puntatore alla routine TapeMiniCreatePartition del driver nastro, che crea una partizione su un nastro. Questa routine è necessaria.

Erase

Puntatore alla routine tape miniclasse TapeMiniErase , che cancella un nastro. Questa routine è necessaria.

GetDriveParameters

Puntatore alla routine TapeMiniGetDriveParameters del driver di nastro miniclasse, che gestisce le richieste per ottenere parametri di unità. Questa routine è necessaria.

GetMediaParameters

Puntatore alla routine tape miniclass driver TapeMiniGetMediaParameters , che gestisce le richieste per ottenere parametri multimediali. Questa routine è necessaria.

GetPosition

Puntatore alla routine TapeMiniGetPosition del driver di nastro, che gestisce le richieste per ottenere la posizione di un nastro. Questa routine è necessaria.

GetStatus

Puntatore alla routine TapeMiniGetStatus del driver di nastro miniclasse, che gestisce le richieste di stato. Questa routine è necessaria.

Prepare

Puntatore alla routine TapeMiniPrepare del driver di nastro miniclasse, che prepara un dispositivo nastro. Questa routine è necessaria.

SetDriveParameters

Puntatore alla routine TapeMiniSetDriveParameters del driver di nastro miniclasse, che imposta i parametri di unità. Questa routine è necessaria.

SetMediaParameters

Puntatore alla routine tape miniclass del driver TapeMiniSetMediaParameters , che imposta i parametri multimediali. Questa routine è necessaria.

SetPosition

Puntatore alla routine TapeMiniSetPosition del driver di nastro miniclasse, che posiziona un nastro. Questa routine è necessaria.

WriteMarks

Puntatore alla routine Nastro miniclasse TapeMiniWriteMarks , che scrive segni su nastro. Questa routine è necessaria.

PreProcessReadWrite

Puntatore alla routine tape miniclass driver TapeMiniPreProcessReadWrite , che esegue operazioni specifiche del dispositivo prima di tutte le letture e le scritture. Questa routine è facoltativa e non è necessaria dalla maggior parte dei driver. Se non viene usato, PreProcessReadWrite deve essere NULL.

TapeGetMediaTypes

Puntatore alla routine TapeMiniGetMediaTypes del driver di nastro miniclasse, che ottiene una descrizione di ogni tipo di supporto supportato da un dispositivo nastro. Questa routine è necessaria.

MediaTypesSupported

Indica il numero di tipi multimediali supportati dal dispositivo.

TapeWMIOperations

Puntatore alla routine TapeMiniWMIControl .

Reserved[2]

Riservato.

Commenti

Una routine DriverEntry di nastro chiama TapeClassZeroMemory per cancellare TAPE_INIT_DATA_EX, compilare i membri obbligatori e tutti i membri facoltativi appropriati e TapeClassInitialize con un puntatore a questa struttura.

I nomi delle routine del driver miniclasse nastro indicati nelle descrizioni dei membri di questa struttura sono solo nomi segnaposto. Il prototipo per queste routine viene dichiarato in newtape.h come TAPE_PROCESS_COMMAND_ROUTINE.

Il significato dei parametri di questo prototipo è diverso per ogni routine del driver miniclasse. Per informazioni dettagliate sul modo in cui questi parametri vengono usati, vedere le descrizioni per ogni singola routine del driver miniclasse.