TAPE_EXTENSION_INIT_ROUTINE fonction de rappel (minitape.h)

Article
03/01/2024

ExtensionInit initialise une zone de contexte facultative spécifique au pilote. Cette routine est appelée par TapeClassInitialize lorsque le pilote 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’interrogation SCSI pour le périphérique à bande.

[in] ModeCapabilitiesPage

Pointeur vers une mémoire tampon qui contient des informations de bas niveau pour le périphérique à bande. Le format de cette page est défini par la norme QIC 157 et est susceptible d’être modifié. Cette valeur est NULL si l’appareil ne prend pas en charge une page de fonctionnalités de mode.

Valeur de retour

None

Remarques

Un pilote de miniclasse sur bande demande une extension minitape en spécifiant une valeur différente de zéro pour MinitapeExtensionSize dans la structure TAPE_INIT_DATA_EX qu’il transmet à 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’interrogation pour les appareils qu’elle prend en charge.

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

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