FltGetFilterFromInstance, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetFilterFromInstance retourne un pointeur de filtre opaque pour le pilote minifilter qui a créé l’instance donnée.

Syntaxe

NTSTATUS FLTAPI FltGetFilterFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_FILTER   *RetFilter
);

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’instance.

[out] RetFilter

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

Valeur de retour

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

Retourner le code	Description
STATUS_FLT_DELETING_OBJECT	Le pilote minifilter est en train d’être détruit. Il s’agit d’un code d’erreur.

Remarques

FltGetFilterFromInstance 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 à FltGetFilterFromInstance doit être mis en correspondance par un appel ultérieur à FltObjectDereference.

Pour obtenir un pointeur de volume opaque pour le volume auquel une instance de pilote minifilter donnée est attachée, appelez FltGetVolumeFromInstance.

Pour énumérer toutes les instances d’un pilote minifilter donné, appelez FltEnumerateInstanceInformationByFilter.

Pour énumérer les instances de tous les pilotes minifilter sur tous les volumes, appelez FltEnumerateInstances.