Fonction FltGetFilterFromName (fltkernel.h)
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 |
---|---|
|
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. |
|
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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Universal |
En-tête | fltkernel.h (inclure Fltkernel.h) |
Bibliothèque | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour