TAPE_EXTENSION_INIT_ROUTINE Rückruffunktion (minitape.h)
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
Zeigen Sie beim Initialisieren auf einen Puffer der Größe, die vom Band-Miniklassentreiber angefordert wird.
[in] InquiryData
Zeigen Sie auf die SCSI-Untersuchungsdaten für das Bandgerät.
[in] ModeCapabilitiesPage
Zeigen Sie 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
Nichts
Bemerkungen
Ein Tape Miniclass-Treiber fordert eine Minitape-Erweiterung an, indem ein Wert ungleich Null für MinitapeExtensionSize- in der TAPE_INIT_DATA_EX-Struktur angegeben wird, die er an TapeClassInitialize von seiner DriverEntry Routine übergibt. Ein Miniklassentreiber definiert die Struktur und den Inhalt der Minitape-Erweiterung und verwendet ihn in der Regel zum Speichern von Untersuchungsdaten für die unterstützten Geräte.
Der Bandklassentreiber weist die Minitape-Erweiterung zu und liefert sie anschließend in Aufrufen der Tape Miniclass-Treiberroutinen, die die gerätespezifischen Aspekte von Gerätesteuerungsanforderungen und den optionalen TapeMiniTapeError Routine des Miniklassentreibers verarbeiten.
ExtensionInit die Minitape-Erweiterung initialisiert, und der Miniklassentreiber verwendet diesen Bereich, um den Laufzeitzustand für sein Gerät aufrechtzuerhalten. Der Bandklassentreiber übergibt InquiryData- und eine ModeCapabilitiesPage- an diese Routine, da diese Strukturen Informationen enthalten, die ein Band-Miniklassentreiber in der Minitape-Erweiterung speichern möchte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | minitape.h (include Minitape.h) |