Fonction FltLoadFilter (fltkernel.h)

La routine FltLoadFilter charge dynamiquement un pilote de minifiltre dans le système en cours d’exécution.

Syntaxe

NTSTATUS FLTAPI FltLoadFilter(
  [in] PCUNICODE_STRING FilterName
);

Paramètres

[in] FilterName

Pointeur vers une structure de UNICODE_STRING contenant le nom de service du pilote de minifiltre.

Valeur retournée

FltLoadFilter retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour Description
STATUS_DRIVER_FAILED_PRIOR_UNLOAD
Impossible de charger le pilote de minifiltre, car une version précédente du pilote est toujours en mémoire. Il s’agit d’un code d’erreur.
STATUS_FAILED_DRIVER_ENTRY
La routine DriverEntry du pilote minifiltre a retourné une valeur NTSTATUS qui n’était pas un code de réussite. Il s’agit d’un code d’erreur.
STATUS_IMAGE_ALREADY_LOADED
Le pilote de minifiltre est déjà en cours d’exécution. Il s’agit d’un code d’erreur.
STATUS_OBJECT_NAME_NOT_FOUND
Aucun pilote de minifiltre correspondant n’a été trouvé. Il s’agit d’un code d’erreur.

Remarques

Un pilote de minifiltre qui a une dépendance sur un autre pilote de minifiltre peut charger ce pilote de minifiltre en appelant FltLoadFilter.

Pour décharger le pilote minifilter pris en charge, appelez FltUnloadFilter.

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

FltUnloadFilter

UNICODE_STRING