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 pilote de miniclasse changer. 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 du Registre pour le pilote miniclass de changement. Cela est également passé en tant que paramètre à la routine DriverEntry du pilote miniclass. Le format de celui-ci est spécifique au système d’exploitation et ne doit pas être interprété par le pilote miniclasse.
ChangerInitData
Pointeur vers une structure MCD_INIT_DATA contenant des informations spécifiques au pilote miniclasse, telles que les points d’entrée des routines de traitement des commandes du pilote miniclass de changement.
Valeur de retour
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 doivent pas interpréter cette valeur d’erreur, mais doivent simplement renvoyer 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 changement telles que l’inscription des routines de répartition du pilote 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 d’accès et les pointeurs du registre du pilote à certaines routines de pilotes de classe de changement spécifiques au système d’exploitation.
Les pilotes miniclass de changement doivent allouer une structure MCD_INIT_DATA, zéro la structure en appelant RtlZeroMemory, puis attribuer des valeurs aux membres appropriés, avant de passer l’adresse de la structure à ChangerClassInitialize au moyen du paramètre MCDInitData.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | mcd.h (include Mcd.h, Ntddchgr.h) |
| bibliothèque | Mcd.lib |