Fonction FltUnloadFilter (fltkernel.h)
Un pilote minifilter qui a chargé un pilote minifilter de prise en charge en appelant FltLoadFilter peut décharger le pilote minifilter en appelant FltUnloadFilter.
Syntaxe
NTSTATUS FLTAPI FltUnloadFilter(
[in] PCUNICODE_STRING FilterName
);
Paramètres
[in] FilterName
Pointeur vers une structure UNICODE_STRING contenant le nom du service de pilote minifilter qui a été passé à FltLoadFilter.
Valeur retournée
FltUnloadFilter retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :
| Code de retour | Description |
|---|---|
|
Un pilote de minifiltre correspondant a été trouvé, mais il est déjà en cours de panne. Il s’agit d’un code d’erreur. |
|
Aucun pilote minifilter correspondant n’a été trouvé. Il s’agit d’un code d’erreur. |
Remarques
Un pilote minifilter qui a une dépendance sur un autre pilote minifilter peut décharger ce pilote minifilter en appelant FltUnloadFilter. Cette routine recherche un pilote minifilter inscrit dont le nom de service correspond au FilterName donné et appelle la routine FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) du pilote minifilter.
Si le pilote minifilter de prise en charge n’a pas inscrit une routine FilterUnloadCallback , l’appel à FltUnloadFilter échoue.
Un pilote minifilter ne peut pas appeler FltUnloadFilter pour se décharger lui-même.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | fltkernel.h (inclure Fltkernel.h) |
| Bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |