ChangerClassInitialize, fonction (mcd.h)
La routine ChangerClassInitialize initialise le pilote.
Syntaxe
NTSTATUS ChangerClassInitialize(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPath,
PMCD_INIT_DATA ChangerInitData
);
Paramètres
[in] DriverObject
Pointeur vers l’objet de pilote de miniclasse de changeur. Il est passé en tant que paramètre à la routine DriverEntry du pilote miniclasse. Le format de cet objet est spécifique au système d’exploitation et ne doit pas être interprété par le pilote miniclass.
[in] RegistryPath
Pointeur vers le chemin d’accès du Registre pour le pilote de miniclasse changer. Cela est également passé en tant que paramètre à la routine DriverEntry du pilote miniclasse. Le format de celui-ci est spécifique au système d’exploitation et ne doit pas être interprété par le pilote miniclass.
ChangerInitData
Pointeur vers une structure de MCD_INIT_DATA contenant des informations spécifiques au pilote de miniclasse, telles que les points d’entrée pour les routines de traitement des commandes du pilote de miniclasse du changeur.
Valeur retournée
ChangerClassInitialize retourne une valeur indiquant la réussite ou l’échec de l’initialisation du pilote. Si l’initialisation réussit, ChangerClassInitialize retourne STATUS_SUCCESS. Sinon, ChangerClassInitialize retourne un message d’erreur approprié. Les minidrivers ne doivent pas interpréter cette valeur d’erreur, mais doivent simplement retourner cette valeur à partir de leur routine DriverEntry .
Remarques
ChangerClassInitialize est une routine de pilote de classe de changement que les pilotes de miniclasse peuvent appeler dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs.
Les pilotes de miniclasse changer appellent ChangerClassInitialize à partir de leurs routines DriverEntry pour initialiser le pilote. ChangerClassInitialize effectue de nombreuses tâches précédemment effectuées par la routine DriverEntry du pilote de la classe changer, telles que l’inscription des routines de répartition du pilote de miniclasse. Il alloue une extension d’objet de pilote et copie les données contenues dans MCDInitData dans l’extension d’objet du pilote, ainsi que d’autres données d’initialisation, telles que le chemin du Registre du pilote et des pointeurs vers certaines routines de pilotes de classe de changement qui sont spécifiques au système d’exploitation.
Les pilotes de miniclasse changer doivent allouer une structure MCD_INIT_DATA , zéro la structure en appelant RtlZeroMemory, puis affecter des valeurs aux membres appropriés, avant de passer l’adresse de la structure à ChangerClassInitialize au moyen du paramètre MCDInitData .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | mcd.h (inclure Mcd.h, Ntddchgr.h) |
| Bibliothèque | Mcd.lib |