Fonction FilterGetInformation (fltuser.h)

Article
08/23/2023

La fonction FilterGetInformation retourne différents types d’informations sur un minifiltre.

Syntaxe

HRESULT FilterGetInformation(
  [in]  HFILTER                  hFilter,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Paramètres

[in] hFilter

Handle retourné par un appel précédent à la fonction FilterCreate .

[in] dwInformationClass

Type d’informations demandées. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FilterFullInformation	Retourne une structure FILTER_FULL_INFORMATION pour le minifiltre.
FilterAggregateBasicInformation	Retourne une structure FILTER_AGGREGATE_BASIC_INFORMATION pour le minifiltre. Cette valeur dwInformationClass est disponible à partir de Microsoft Windows Server 2003 avec SP1 et de Microsoft Windows XP avec SP2 avec le correctif cumulatif du gestionnaire de filtres. Pour plus d’informations sur le package cumulatif du gestionnaire de filtres pour Windows XP avec SP2, consultez l’article 914882, « Le package cumulatif du gestionnaire de filtres pour Windows XP SP2 », dans la Base de connaissances Microsoft.
FilterAggregateStandardInformation	Retourne une structure FILTER_AGGREGATE_STANDARD_INFORMATION pour chaque minifiltre. La partie LegacyFilter de la structure n’est pas utilisée. Cette valeur dwInformationClass est disponible à partir de Windows Vista.

[out] lpBuffer

Pointeur vers une mémoire tampon allouée à 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 dwInformationClass .

[in] dwBufferSize

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

[out] lpBytesReturned

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 lpBuffer pointe si l’appel à FilterGetInformation réussit. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Valeur retournée

FilterGetInformation retourne S_OK en cas de réussite. Sinon, il retourne une valeur d’erreur HRESULT, telle que l’une des valeurs suivantes :

Code de retour	Description
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	La mémoire tampon pointée par lpBuffer n’est pas assez grande pour contenir les informations demandées. Lorsque cette valeur est retournée, lpBytesReturned contient la taille, en octets, de la mémoire tampon requise pour la structure dwInformationClass donnée.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Une valeur non valide a été spécifiée pour le paramètre dwInformationClass . Par exemple, si FilterAggregateStandardInformation est spécifié pour un système d’exploitation antérieur à Windows Vista, FilterGetInformation retourne cette valeur HRESULT.