FltUnloadFilter, fonction (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 de retour
FltUnloadFilter retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des suivantes :
| Retourner le code | Description |
|---|---|
|
Un pilote minifilter correspondant a été trouvé, mais il est déjà détruit. 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 du pilote minifilter (PFLT_FILTER_UNLOAD_CALLBACK).
Si le pilote minifilter de prise en charge n’a pas inscrit de routine FilterUnloadCallback, l’appel à FltUnloadFilter échoue.
Un pilote minifilter ne peut pas appeler FltUnloadFilter pour se décharger.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |