Partager via


FltGetFilterInformation, fonction (fltkernel.h)

La routine FltGetFilterInformation fournit des informations sur un pilote minifilter.

Syntaxe

NTSTATUS FLTAPI FltGetFilterInformation(
  [in]  PFLT_FILTER              Filter,
  [in]  FILTER_INFORMATION_CLASS InformationClass,
  [out] PVOID                    Buffer,
  [in]  ULONG                    BufferSize,
  [out] PULONG                   BytesReturned
);

Paramètres

[in] Filter

Pointeur de filtre opaque pour l’appelant.

[in] InformationClass

Type d’informations demandées. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur Signification
filterFullInformation La mémoire tampon pointée par le paramètre de la mémoire tampon reçoit une structure FILTER_FULL_INFORMATION pour le pilote minifilter.
FilterAggregateBasicInformation La mémoire tampon pointée par le paramètre Buffer reçoit une structure FILTER_AGGREGATE_BASIC_INFORMATION pour le pilote minifilter. Cette valeur InformationClass est disponible à partir de Microsoft Windows Server 2003 SP1 et Windows XP SP2 avec cumul du gestionnaire de filtres. Pour plus d’informations sur le package cumulatif du gestionnaire de filtres pour Windows XP SP2, consultez l’article 914882 « Package cumulatif du gestionnaire de filtres pour Windows XP SP2», dans la Base de connaissances Microsoft.
FilterAggregateStandardInformation La mémoire tampon pointée par le paramètre tampon reçoit une structure FILTER_AGGREGATE_STANDARD_INFORMATION pour le pilote minifilter. La partie LegacyFilter de la structure n’est pas utilisée. Cette valeur InformationClass est disponible à partir de Windows Vista.

[out] Buffer

Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit les informations demandées. Le type des informations retournées dans la mémoire tampon est défini par le paramètre InformationClass.

[in] BufferSize

Taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre tampon. L’appelant doit définir ce paramètre en fonction de la valeur InformationClass donnée.

[out] BytesReturned

Pointeur vers une variable allouée par l’appelant qui reçoit le nombre d’octets retournés dans la mémoire tampon vers laquelle tampon pointe. Si la valeur d’entrée de BufferSize est trop petite, FltGetFilterInformation retourne STATUS_BUFFER_TOO_SMALL et définit cette variable sur le nombre d’octets requis pour stocker les informations demandées. Ce paramètre est obligatoire et ne peut pas être NULL.

Valeur de retour

FltGetFilterInformation retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple l’une des valeurs suivantes :

Retourner le code Description
STATUS_BUFFER_TOO_SMALL
Mémoire tampon pour laquelle le paramètre tampon pointe vers n’est pas suffisamment grand pour stocker les informations demandées. Il s’agit d’un code d’erreur.
STATUS_INVALID_PARAMETER
Une valeur non valide a été spécifiée pour le paramètre InformationClass. Par exemple, si FilterAggregateStandardInformation est spécifié sur un système d’exploitation antérieur à Windows Vista, la routine retourne STATUS_INVALID_PARAMETER. Il s’agit d’un code d’erreur.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête fltkernel.h (include FltKernel.h)
bibliothèque FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

Voir aussi

FILTER_AGGREGATE_BASIC_INFORMATION

FILTER_AGGREGATE_STANDARD_INFORMATION

FILTER_FULL_INFORMATION

FltEnumerateFilterInformation

FltEnumerateInstanceInformationByFilter

FltEnumerateInstanceInformationByVolume

FltGetInstanceInformation