TAPE_EXTENSION_INIT_ROUTINE Rückruffunktion (minitape.h)

Artikel
02/29/2024

ExtensionInit initialisiert einen optionalen, treiberspezifischen Kontextbereich. Diese Routine wird von TapeClassInitialize aufgerufen, wenn der Band-Miniklassentreiber geladen wird. Diese Routine ist optional.

Syntax

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

void TapeExtensionInitRoutine(
  [in] PVOID MinitapeExtension,
  [in] PINQUIRYDATA InquiryData,
  [in] PMODE_CAPABILITIES_PAGE ModeCapabilitiesPage
)
{...}

Parameter

[in] MinitapeExtension

Zeiger auf einen Puffer der Größe, die vom Band-Miniklassentreiber bei der Initialisierung angefordert wurde.

[in] InquiryData

Zeiger auf die SCSI-Abfragedaten für das Bandgerät.

[in] ModeCapabilitiesPage

Zeiger auf einen Puffer, der Informationen auf niedriger Ebene für das Bandgerät enthält. Das Format dieser Seite wird durch den QIC 157-Standard definiert und kann geändert werden. Dies ist NULL , wenn das Gerät keine Modusfunktionsseite unterstützt.

Rückgabewert

Keine

Bemerkungen

Ein Band-Miniklassentreiber fordert eine Minibanderweiterung an, indem er einen Wert ungleich 0 (null) für MinitapeExtensionSize in der TAPE_INIT_DATA_EX Struktur angibt, die von der DriverEntry-Routine an TapeClassInitialize übergeben wird. Ein Miniklassentreiber definiert die Struktur und den Inhalt der Minibanderweiterung und verwendet sie in der Regel zum Speichern von Abfragedaten für die unterstützten Geräte.

Der Bandklassentreiber ordnet die Minibanderweiterung zu und liefert sie anschließend in Aufrufen der Band-Miniklassentreiberroutinen, die die gerätespezifischen Aspekte von Gerätesteuerungsanforderungen behandeln, und der optionalen TapeMiniTapeError-Routine des Miniklassentreibers.

ExtensionInit initialisiert die Minibanderweiterung, und der Miniklassentreiber verwendet diesen Bereich, um den Laufzeitzustand für sein Gerät beizubehalten. Der Bandklassentreiber übergibt InquiryData und eine ModeCapabilitiesPage an diese Routine, da diese Strukturen Informationen enthalten, die ein Band-Miniklassentreiber möglicherweise in der Minibanderweiterung speichern möchte.