TAPE_INIT_DATA_EX Struktur (minitape.h)

Artikel
02/07/2025

TAPE_INIT_DATA_EX definiert Werte und Routinen, die für einen Windows 2000-Band-Miniklassentreiber spezifisch sind. Die Tape-Miniklasse DriverEntry Routine übergibt diese Informationen an den Bandklassentreiber, um die Miniklassentreiberinitialisierung abzuschließen.

Syntax

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;

Angehörige

InitDataSize

Größe dieser Struktur in Byte.

VerifyInquiry

Gibt den Einstiegspunkt des Tape Miniclass-Treibers TapeMiniVerifyInquiry Routine an, der bestimmt, ob der Treiber ein bestimmtes Gerät unterstützt. Diese Routine ist erforderlich.

QueryModeCapabilitiesPage

Leitet den Bandklassentreiber an, wenn TRUE- eine Modusfunktionen-Seite an die Tape Miniclass-Treiber TapeMiniVerifyInquiry und TapeMiniExtensionInit Routinen übergeben.

MinitapeExtensionSize

Gibt die Größe eines treiberspezifischen Kontextbereichs in Bytes an. Wenn dieses Element nicht null ist, darf ExtensionInit nicht NULL-sein. Dieser Wert ist optional und muss auf Null festgelegt werden, wenn er nicht verwendet wird.

ExtensionInit

Zeiger auf die Tape Miniclass Treiber TapeMiniExtensionInit Routine, die ggf. eine optionale Minitape-Erweiterung initialisiert. Wenn MiniTapeExtensionSize null ist, muss ExtensionInitNULL-sein.

DefaultTimeOutValue

Gibt die Anzahl der Sekunden an, für die der Bandklassentreiber vor dem Abbrechen auf eine SRB-Anforderung wartet. Wenn dieser Wert null ist, legt der Bandklassentreiber einen geeigneten Standardwert fest. Der Bandklassentreiber verwendet immer den Standardtimeoutwert für Lese- und Schreibanforderungen. Die in der TAPE_INIT_DATA_EX-Struktur enthaltenen Routinen können den Standardtimeoutwert für Gerätesteuerungsanforderungen überschreiben, indem TimeOutValue- in einem SRB festgelegt wird.

TapeError

Zeiger auf die Tape Miniclass Treiber TapeMiniTapeError Routine, die die Fehlerbehandlungsaktivitäten des Bandklassentreibers erweitert. Diese Routine ist optional. Wenn eine nicht verwendet wird, muss TapeError- auf NULL-festgelegt werden.

CommandExtensionSize

Gibt die Größe einer Befehlserweiterung in Bytes an, die vor dem Start jedes Bandbefehls zugewiesen werden soll. Ein Band-Miniklassentreiber verwendet die Befehlserweiterung zum Speichern des Kontexts während der Verarbeitung von Bandbefehlen. Seine Größe und interne Struktur werden durch den Tape Miniclass-Treiber definiert. Eine Befehlserweiterung ist optional. Wenn eine nicht verwendet wird, muss CommandExtensionSize- auf Null festgelegt werden.

CreatePartition

Zeigen Sie auf die TapeMiniCreatePartition Routine des Tape Miniclass-Treibers, die eine Partition auf einem Band erstellt. Diese Routine ist erforderlich.

Erase

Zeiger auf die tape miniclass Treiber TapeMiniErase Routine, die ein Band löscht. Diese Routine ist erforderlich.

GetDriveParameters

Zeigen Sie auf die TapeMiniGetDriveParameters TapeMiniGetDriveParameters, die Anforderungen zum Abrufen von Laufwerkparametern verarbeitet. Diese Routine ist erforderlich.

GetMediaParameters

Zeiger auf die tape miniclass Treiber TapeMiniGetMediaParameters Routine, die Anforderungen zum Abrufen von Medienparametern verarbeitet. Diese Routine ist erforderlich.

GetPosition

Zeiger auf die TapeMiniGetPosition-Routine des TapeMiniGetPosition-Treibers, die Anforderungen verarbeitet, um die Position eines Bandes zu erhalten. Diese Routine ist erforderlich.

GetStatus

Zeiger auf die TapeMiniGetStatus-Routine des TapeMiniGetStatus-Treibers, die Anforderungen für Status verarbeitet. Diese Routine ist erforderlich.

Prepare

Zeigen Sie auf die TapeMiniPrepare TapeMiniPrepare, die ein Bandgerät vorbereitet. Diese Routine ist erforderlich.

SetDriveParameters

Zeiger auf die tape miniclass Treiber TapeMiniSetDriveParameters Routine, die Laufwerkparameter festlegt. Diese Routine ist erforderlich.

SetMediaParameters

Zeiger auf die tape miniclass Treiber TapeMiniSetMediaParameters Routine, die Medienparameter festlegt. Diese Routine ist erforderlich.

SetPosition

Zeiger auf die tape miniclass Treiber TapeMiniSetPosition Routine, die ein Band positioniert. Diese Routine ist erforderlich.

WriteMarks

Zeiger auf die tape miniclass Treiber TapeMiniWriteMarks Routine, die Markierungen auf Band schreibt. Diese Routine ist erforderlich.

PreProcessReadWrite

Zeiger auf die TapeMiniPreProcessReadWrite-Routine des TapeMiniPreProcessReadWrite-Treibers, die gerätespezifische Vorgänge vor allen Lese- und Schreibvorgängen ausführt. Diese Routine ist optional und wird von den meisten Treibern nicht benötigt. Wenn eine nicht verwendet wird, muss PreProcessReadWrite-NULL-sein.

TapeGetMediaTypes

Zeiger auf die tape miniclass Treiber TapeMiniGetMediaTypes Routine, die eine Beschreibung der einzelnen Medientypen erhält, die von einem Bandgerät unterstützt werden. Diese Routine ist erforderlich.

MediaTypesSupported

Gibt die Anzahl der vom Gerät unterstützten Medientypen an.

TapeWMIOperations

Zeiger auf die TapeMiniWMIControl Routine.

Reserved[2]

Reserviert.

Bemerkungen

Die DriverEntry Routineaufrufe eines TapeClassZeroMemory-Treibers TapeClassZeroMemory, um TAPE_INIT_DATA_EX zu löschen, die erforderlichen Member und alle entsprechenden optionalen Member auszufüllen, und TapeClassInitialize mit einem Zeiger auf diese Struktur.

Die Namen der Tape Miniclass-Treiberroutinen, die in den Memberbeschreibungen dieser Struktur angegeben sind, sind nur Platzhalternamen. Der Prototyp für diese Routinen wird in newtape.h als TAPE_PROCESS_COMMAND_ROUTINEdeklariert.

Die Bedeutung der Parameter dieses Prototyps unterscheidet sich für jede Miniklassentreiberroutine. Ausführliche Informationen dazu, wie diese Parameter verwendet werden, finden Sie in den Beschreibungen für jede einzelne Miniklassentreiberroutine.