TapeClassInitialize-Funktion (minitape.h)
Die TapeClassInitialize Routine führt einen Großteil der Treiber- und Geräteinitialisierung im Auftrag eines Miniklassentreibers durch. TapeClassInitialize lädt die Einstiegspunkte der Bandklasse-Treiber für Band-E/A-Anforderungen in die Datenstruktur des Miniklassentreibers, sucht und behauptet nicht beanspruchte Bandgeräte, die der Miniklassentreiber unterstützt, und ordnet die Betriebssystemressourcen für den Miniklassentreiber und seine Geräte zu und initialisiert sie. TapeClassInitialize- verwendet Miniklassentreiberspezifische Informationen, die in TapeInitData- bereitgestellt werden, und ruft den Tape Miniclass-Treiber für treiberspezifische Vorgänge zurück.
Syntax
SCSIPORT_API ULONG TapeClassInitialize(
[in] PVOID Argument1,
[in] PVOID Argument2,
[in] PTAPE_INIT_DATA_EX TapeInitData
);
Parameter
[in] Argument1
Zeiger auf Treiberkontextinformationen, die an die DriverEntry Routine des Band-Miniklassentreibers übergeben wurden. Das Format der Informationen ist betriebssystemspezifisch und darf nicht von einem Band-Miniklassentreiber interpretiert werden.
[in] Argument2
Zeiger auf die zweite Treiberkontextstruktur, die an die DriverEntry Routine des Band-Miniklassentreibers übergeben wurde. Das Format der Informationen ist betriebssystemspezifisch und darf nicht von einem Band-Miniklassentreiber interpretiert werden.
[in] TapeInitData
Zeigen Sie auf eine TAPE_INIT_DATA_EX Struktur, die treiberspezifische Informationen enthält, z. B. die Einstiegspunkte für die Befehlsverarbeitungsroutinen des Tape miniclass-Treibers.
Rückgabewert
TapeClassInitialize gibt einen Wert zurück, der den Erfolg oder Fehler der Treiberinitialisierung angibt. Der Tape Miniclass-Treiber übergibt diesen Wert, nicht interpretiert, als Rückgabewert aus seiner DriverEntry-Routine.
Bemerkungen
Ein Tape Miniclass-Treiber ruft TapeClassInitialize aus seiner DriverEntry- routine auf und übergibt treiberspezifische Informationen in TapeInitData-. TapeClassInitialize führt einen großen Teil der Treiberinitialisierung im Namen des Miniklassentreibers durch und isoliert den Miniklassentreiber von betriebssystemspezifischen Details.
TapeClassInitialize ruft den Tape Miniclass-Treiber für treiberspezifische Aktivitäten auf, die während der Initialisierung erforderlich sind. Beispielsweise ruft TapeClassInitialize die TapeMiniVerifyInquiry-Routine des TapeMiniVerifyInquiry-Treibers auf, um festzustellen, ob der Treiber ein bestimmtes Bandgerät unterstützt. TapeClassInitialize ruft auch die TapeMiniExtensionInit-Routine des TapeMiniClass-Treibers auf, um die Minitape-Erweiterung zu initialisieren, wenn der Miniklassentreiber einen angefordert hat.
Ein Tape Miniclass-Treiber weist eine TAPE_INIT_DATA_EX Struktur auf dem Stapel zu, löscht sie mit TapeClassZeroMemory, füllt alle geeigneten Member ein und übergibt sie an TapeClassInitialize.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | minitape.h (include Minitape.h) |
| Library | Tape.lib |