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 |