TAPE_EXTENSION_INIT_ROUTINE fonction de rappel (minitape.h)

Article
02/07/2025

ExtensionInit initialise une zone de contexte facultative spécifique au pilote. Cette routine est appelée par TapeClassInitialize lorsque le pilote de miniclasse de bande est chargé. Cette routine est facultative.

Syntaxe

TAPE_EXTENSION_INIT_ROUTINE TapeExtensionInitRoutine;

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

Paramètres

[in] MinitapeExtension

Pointeur vers une mémoire tampon de la taille demandée par le pilote miniclasse de bande lors de son initialisation.

[in] InquiryData

Pointeur vers les données d’enquête SCSI pour l’appareil à bande.

[in] ModeCapabilitiesPage

Pointeur vers une mémoire tampon qui contient des informations de bas niveau pour l’appareil à bande. Le format de cette page est défini par la norme QIC 157 et est susceptible de changer. Il s’agit NULL si l’appareil ne prend pas en charge une page de fonctionnalités de mode.

Valeur de retour

Aucun

Remarques

Un pilote de miniclasse de bande demande une extension de minitape en spécifiant une valeur différente de zéro pour MinitapeExtensionSize dans la structure TAPE_INIT_DATA_EX qu’il passe à TapeClassInitialize à partir de sa routine DriverEntry. Un pilote de miniclasse définit la structure et le contenu de l’extension minitape et l’utilise généralement pour stocker les données d’enquête pour les appareils qu’il prend en charge.

Le pilote de classe de bande alloue l’extension minitape et le fournit par la suite dans les appels aux routines du pilote miniclasse de bande qui gèrent les aspects spécifiques de l’appareil des demandes de contrôle d’appareil et à la routine facultative TapeMiniTapeError du pilote miniclasse.

ExtensionInit initialise l’extension de minitape, et le pilote miniclasse utilise cette zone pour maintenir l’état d’exécution de son appareil. Le pilote de classe de bande passe InquiryData et un ModeCapabilitiesPage à cette routine, car ces structures contiennent des informations qu’un pilote miniclasse de bande peut souhaiter stocker dans l’extension minitape.