Partager via


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
STATUS_FLT_DELETING_OBJECT
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.
STATUS_FLT_FILTER_NOT_FOUND
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

Voir aussi

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING