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