Fonction FltSetEcpListIntoCallbackData (fltkernel.h)

Article
08/07/2023

La routine FltSetEcpListIntoCallbackData attache une liste supplémentaire create parameter context structure (ECP) à un objet create operation callback-data.

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 callback-data 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 ECP, à attacher à l’objet callback-data.

Valeur retournée

FltSetEcpListIntoCallbackData retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	La liste ECP donnée a été correctement attachée à l’objet callback-data 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 callback-data donné.

Remarques

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

Pour récupérer une liste ECP jointe à partir d’un objet callback-data donné, utilisez la routine FltGetEcpListFromCallbackData .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible à partir de Windows Vista.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL