Fonction ZwLoadDriver (wdm.h)
La routine ZwLoadDriver charge un pilote dans le système.
Syntaxe
NTSYSAPI NTSTATUS ZwLoadDriver(
[in] PUNICODE_STRING DriverServiceName
);
Paramètres
[in] DriverServiceName
Pointeur vers une chaîne Unicode comptée qui spécifie un chemin d’accès à la clé de Registre du pilote, \Registry\Machine\System\CurrentControlSet\Services\<DriverName>, où <DriverName> est le nom du pilote.
Valeur retournée
ZwLoadDriver retourne STATUS_SUCCESS ou une valeur NTSTATUS d’erreur appropriée.
Remarques
ZwLoadDriver charge dynamiquement un pilote de système de fichiers ou d’appareil dans le système en cours d’exécution.
Si le système s’exécute en mode sans échec et que le pilote ne parvient pas à charger, car il ne figure pas dans la liste des modes sans échec, ZwLoadDriver retourne STATUS_SUCCESS.
Un minifiltre doit utiliser FltLoadFilter au lieu de ZwLoadDriver pour charger un minifiltre de prise en charge.
Si l’appel à la fonction ZwLoadDriver se produit en mode utilisateur, vous devez utiliser le nom « NtLoadDriver » au lieu de « ZwLoadDriver ».
Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm) |
Voir aussi
Utilisation des versions Nt et Zw des routines natives des services système natifs