FltGetInstanceInformation, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetInstanceInformation retourne des informations sur une instance de pilote minifilter.

Syntaxe

NTSTATUS FLTAPI FltGetInstanceInformation(
  [in]  PFLT_INSTANCE              Instance,
  [in]  INSTANCE_INFORMATION_CLASS InformationClass,
  [out] PVOID                      Buffer,
  [in]  ULONG                      BufferSize,
  [out] PULONG                     BytesReturned
);

Paramètres

[in] Instance

Pointeur d’instance opaque pour l’appelant.

[in] InformationClass

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

Valeur	Signification
InstanceBasicInformation	La mémoire tampon pointée par le paramètre Buffer reçoit une structure INSTANCE_BASIC_INFORMATION pour l’instance.
InstanceFullInformation	La mémoire tampon pointée par le paramètre de tampon reçoit une structure INSTANCE_FULL_INFORMATION pour l’instance.
InstancePartialInformation	La mémoire tampon pointée par le paramètre tampon reçoit une structure INSTANCE_PARTIAL_INFORMATION pour l’instance.
InstanceAggregateStandardInformation	La mémoire tampon pointée par le paramètre Buffer reçoit une structure INSTANCE_AGGREGATE_STANDARD_INFORMATION pour l’instance. La partie LegacyFilter de la structure n’est pas utilisée. Cette structure 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, FltGetInstanceInformation 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

FltGetInstanceInformation 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 InstanceAggregateStandardInformation est spécifié sur les systèmes d’exploitation antérieurs à Windows Vista, la routine retourne STATUS_INVALID_PARAMETER. Il s’agit d’un code d’erreur.

Remarques

Étant donné un pointeur vers une instance de minifilter, cette routine retourne des informations sur l’instance de minifilter. Le type d’informations d’instance retournées est déterminé par le paramètre InformationClass.