Fonction ZwUnloadDriver (wdm.h)
La routine ZwUnloadDriver décharge un pilote du système. Utilisez cette routine avec une extrême prudence (voir la section Remarques ci-dessous).
Syntaxe
NTSYSAPI NTSTATUS ZwUnloadDriver(
[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
ZwUnloadDriver retourne STATUS_SUCCESS ou une valeur NTSTATUS d’erreur telle que STATUS_INVALID_DEVICE_REQUEST.
Si le pilote spécifié dans DriverServiceName n’a aucune routine de rappel DriverUnload définie dans sa structure de DRIVER_OBJECT , ZwUnloadDriver retourne STATUS_INVALID_DEVICE_REQUEST.
Remarques
ZwUnloadDriver décharge dynamiquement un pilote de système de fichiers ou d’appareil du système en cours d’exécution. Il n’est pas recommandé qu’un pilote appelle ZwUnloadDriver sur lui-même.
Un pilote de filtre de système de fichiers ne peut pas être déchargé en toute sécurité d’un système en cours d’exécution. Par conséquent, un filtre doit uniquement utiliser ZwUnloadDriver à des fins de débogage. Il ne doit pas appeler cette routine dans une version commerciale du filtre.
Si DriverName est le nom d’un pilote de périphérique PnP, ZwUnloadDriver retourne STATUS_INVALID_DEVICE_REQUEST et ne décharge pas le pilote.
Un minifiltre doit utiliser FltUnloadFilter au lieu de ZwUnloadDriver pour décharger un minifiltre de prise en charge.
Si l’appel à la fonction ZwUnloadDriver se produit en mode utilisateur, vous devez utiliser le nom « NtUnloadDriver » au lieu de « ZwUnloadDriver ».
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