Fonction TapeClassInitialize (minitape.h)

La routine TapeClassInitialize effectue une grande partie de l’initialisation des pilotes et des périphériques pour le compte d’un pilote de miniclasse. TapeClassInitialize charge les points d’entrée du pilote de classe de bande pour les demandes d’E/S sur bande dans la structure de données du pilote miniclasse, localise et revendique les périphériques à bande non réclamés que le pilote de miniclasse prend en charge, et alloue et initialise les ressources du système d’exploitation pour le pilote de miniclasse et ses périphériques. TapeClassInitialize utilise les informations spécifiques au pilote miniclasse fournies dans TapeInitData et rappelle le pilote de miniclasse sur bande pour les opérations spécifiques au pilote.

Syntaxe

SCSIPORT_API ULONG TapeClassInitialize(
  [in] PVOID              Argument1,
  [in] PVOID              Argument2,
  [in] PTAPE_INIT_DATA_EX TapeInitData
);

Paramètres

[in] Argument1

Pointeur vers les informations de contexte du pilote qui ont été transmises à la routine DriverEntry du pilote de la mini-classe sur bande. Le format des informations est spécifique au système d’exploitation et ne doit pas être interprété par un pilote de miniclasse sur bande.

[in] Argument2

Pointeur vers la deuxième structure de contexte de pilote qui a été passée à la routine DriverEntry du pilote de la miniclasse sur bande. Le format des informations est spécifique au système d’exploitation et ne doit pas être interprété par un pilote de miniclasse sur bande.

[in] TapeInitData

Pointeur vers une structure de TAPE_INIT_DATA_EX contenant des informations spécifiques au pilote, telles que les points d’entrée pour les routines de traitement des commandes du pilote de la mini-classe de bande.

Valeur retournée

TapeClassInitialize retourne une valeur indiquant la réussite ou l’échec de l’initialisation du pilote. Le pilote de miniclasse sur bande transmet cette valeur, sans interprétation, comme valeur de retour de sa routine DriverEntry .

Remarques

Un pilote de miniclasse de bande appelle TapeClassInitialize à partir de sa routine DriverEntry et transmet des informations spécifiques au pilote dans TapeInitData. TapeClassInitialize effectue une grande partie de l’initialisation du pilote pour le compte du pilote miniclasse et isole le pilote de la miniclasse des détails spécifiques au système d’exploitation.

TapeClassInitialize appelle le pilote miniclasse de bande pour les activités spécifiques au pilote requises lors de l’initialisation. Par exemple, TapeClassInitialize appelle la routine TapeMiniVerifyInquiry du pilote de bande miniclasse pour déterminer si le pilote prend en charge un périphérique à bande donné. TapeClassInitialize appelle également la routine TapeMiniExtensionInit du pilote de la miniclasse pour initialiser l’extension minitape, si le pilote de la miniclasse en a demandé une.

Un pilote de miniclasse de bande alloue une structure TAPE_INIT_DATA_EX sur la pile, la efface avec TapeClassZeroMemory, remplit tous les membres appropriés et la transmet à TapeClassInitialize.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	minitape.h (inclure Minitape.h)
Bibliothèque	Tape.lib

Voir aussi

DriverEntry of Tape Miniclass Driver

TAPE_INIT_DATA_EX