FltSetEcpListIntoCallbackData, fonction (fltkernel.h)

Article
02/06/2025

La routine FltSetEcpListIntoCallbackData attache une liste ecP (Create Parameter Context Structure) supplémentaire à un objet de données de rappel d’opération de création.

Syntaxe

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

Paramètres

[in] Filter

Pointeur de filtre opaque vers le pilote minifilter. Ce pointeur identifie de façon unique le pilote minifilter et reste constant tant que le pilote minifilter est chargé.

CallbackData

Pointeur vers un objet de données de rappel de type FLT_CALLBACK_DATA, qui représente l’opération de création.

[in] EcpList

Pointeur vers la liste ECP, qui contient un ou plusieurs PCE, à attacher à l’objet de données de rappel.

Valeur de retour

FltSetEcpListIntoCallbackData retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	La liste ECP donnée a été attachée avec succès à l’objet de données de rappel donné.
STATUS_INVALID_PARAMETER_2	L’objet de données de rappel donné n’était pas une opération de création basée sur IRP.
STATUS_INVALID_PARAMETER_3	Une liste ECP a déjà été attachée à l’objet de données de rappel donné.

Remarques

La routine FltSetEcpListIntoCallbackData fournit un mécanisme permettant de transmettre des paramètres de création supplémentaires à la pile de filtres du système de fichiers aux pilotes de filtres minifilter et hérités sous-jacents.

Pour récupérer une liste ECP jointe à partir d’un objet de données de rappel donné, utilisez la routine FltGetEcpListFromCallbackData.

Exigences

Exigence	Valeur
client minimum pris en charge	Cette routine est disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	fltkernel.h (include Fltkernel.h)
bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL