FilterVolumeInstanceFindNext, fonction (fltuser.h)

Article
02/27/2024

La fonction FilterVolumeInstanceFindNext poursuit une recherche de pilote minifilter instance ou de pilote de filtre hérité démarrée par un appel à FilterVolumeInstanceFindFirst.

Syntaxe

HRESULT FilterVolumeInstanceFindNext(
  [in]  HANDLE                     hVolumeInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Paramètres

[in] hVolumeInstanceFind

Handle de recherche du pilote de filtre de volume retourné par un appel précédent à FilterVolumeInstanceFindFirst.

[in] dwInformationClass

Type de structure d’informations de pilote de filtre retournée. Ce paramètre doit contenir l’une des valeurs suivantes.

Valeur	Signification
InstanceBasicInformation	Retourne une structure INSTANCE_BASIC_INFORMATION pour un minifiltre instance. Les pilotes de filtre hérités sont ignorés.
InstanceFullInformation	Retourne une structure INSTANCE_FULL_INFORMATION pour un minifiltre instance. Les pilotes de filtre hérités sont ignorés.
InstancePartialInformation	Retourne une structure INSTANCE_PARTIAL_INFORMATION pour un minifiltre instance. Les pilotes de filtre hérités sont ignorés.
InstanceAggregateStandardInformation	Retourne une structure INSTANCE_AGGREGATE_STANDARD_INFORMATION pour le instance. Le membre LegacyFilter de la structure n’est pas utilisé. Cette structure 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 à FilterVolumeInstanceFindNext réussit. Ce paramètre est obligatoire et ne peut pas être NULL.

Valeur retournée

FilterVolumeInstanceFindNext retourne S_OK en cas de réussite. Sinon, elle retourne une valeur d’erreur HRESULT, telle que l’une des 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 InstanceAggregateStandardInformation est spécifié pour un système d’exploitation antérieur à Windows Vista, FilterVolumeInstanceFindNext renvoie cette valeur HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Aucun autre pilote de filtre n’a été trouvé sur le volume donné.

Remarques

FilterVolumeInstanceFindNext recherche un pilote de filtre par appel.

Une fois le handle de recherche établi en appelant FilterVolumeInstanceFindFirst, utilisez la fonction FilterVolumeInstanceFindNext pour rechercher d’autres pilotes de filtre attachés au volume spécifié dans l’appel à FilterVolumeInstanceFindFirst. Lorsque le handle de recherche n’est plus nécessaire, fermez-le en appelant FilterVolumeInstanceFindClose.

À compter de Windows Vista, cette routine peut retourner des informations sur le pilote de filtre hérité et le pilote minifilter instance des informations lorsque la valeur du paramètre dwInformationClass est InstanceAggregateStandardInformation. Pour les systèmes d’exploitation antérieurs, cette routine ne peut pas retourner les informations de filtre héritées, car la structure INSTANCE_AGGREGATE_STANDARD_INFORMATION n’est pas disponible.