Fonction FltGetFilterFromName (fltkernel.h)

Article
02/29/2024

La routine FltGetFilterFromName retourne un pointeur de filtre opaque pour un pilote de minifiltre 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 minifiltre. (La comparaison de noms ne respecte pas la casse.)

[out] RetFilter

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

Valeur retournée

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

Code de retour	Description
STATUS_FLT_DELETING_OBJECT	Un pilote de minifiltre correspondant a été trouvé, mais il est en train d’être détruit. Il s’agit d’un code d’erreur.
STATUS_FLT_FILTER_NOT_FOUND	Aucun pilote de minifiltre 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. Par conséquent, chaque appel réussi à FltGetFilterFromName doit être mis en correspondance par un appel ultérieur à FltObjectDereference.

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