TAPE_EXTENSION_INIT_ROUTINE funzione di callback (minitape.h)

Articolo
02/29/2024

ExtensionInit inizializza un'area di contesto facoltativa specifica del driver. Questa routine viene chiamata da TapeClassInitialize quando viene caricato il driver di miniclasse nastro. Questa routine è facoltativa.

Sintassi

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

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

Parametri

[in] MinitapeExtension

Puntatore a un buffer delle dimensioni richieste dal driver miniclasse nastro al momento dell'inizializzazione.

[in] InquiryData

Puntatore ai dati di richiesta SCSI per il dispositivo nastro.

[in] ModeCapabilitiesPage

Puntatore a un buffer che contiene informazioni di basso livello per il dispositivo nastro. Il formato di questa pagina è definito dallo standard QIC 157 ed è soggetto a modifiche. Questo valore è NULL se il dispositivo non supporta una pagina delle funzionalità della modalità.

Valore restituito

nessuno

Osservazioni

Un driver miniclasse nastro richiede un'estensione minitape specificando un valore diverso da zero per MinitapeExtensionSize nella struttura TAPE_INIT_DATA_EX passa a TapeClassInitialize dalla routine DriverEntry . Un driver miniclasse definisce la struttura e il contenuto dell'estensione minitape e in genere lo usa per archiviare i dati di richiesta per i dispositivi supportati.

Il driver di classe nastro alloca l'estensione minitape e la fornisce successivamente nelle chiamate alle routine del driver di miniclasse nastro che gestiscono gli aspetti specifici del dispositivo delle richieste di controllo del dispositivo e alla routine facoltativa tapeMiniTapeError del driver miniclasse.

ExtensionInit inizializza l'estensione minitape e il driver miniclass usa questa area per mantenere lo stato di runtime per il dispositivo. Il driver della classe nastro passa InquiryData e ModeCapabilitiesPage a questa routine perché tali strutture contengono informazioni che un driver di miniclasse nastro potrebbe voler archiviare nell'estensione minitape.