FltGetFilterFromName, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetFilterFromName retourne un pointeur de filtre opaque pour un pilote minifilter inscrit dont le nom correspond à la valeur dans le paramètre FilterName.

Syntaxe

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

Paramètres

[in] FilterName

Pointeur vers une structure UNICODE_STRING contenant le nom du pilote minifilter. (La comparaison de noms ne respecte pas la casse.)

[out] RetFilter

Pointeur vers une variable allouée par l’appelant qui reçoit un pointeur de filtre opaque pour le pilote minifilter dont le nom correspond au nom dans le paramètre FilterName. Ce paramètre est obligatoire et ne peut pas être NULL.

Valeur de retour

FltGetFilterFromName retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des suivantes :

Retourner le code	Description
STATUS_FLT_DELETING_OBJECT	Un pilote minifilter correspondant a été trouvé, mais il est détruit. 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

FltGetFilterFromName ajoute une référence d’exécution au pointeur de filtre opaque retourné dans le paramètre RetFilter. Lorsque ce pointeur n’est plus nécessaire, l’appelant doit le libérer en appelant FltObjectDereference. Ainsi, chaque appel réussi à FltGetFilterFromName doit être mis en correspondance par un appel ultérieur à FltObjectDereference.

Pour inscrire un pilote minifilter auprès du Gestionnaire de filtres, appelez FltRegisterFilter.