Fonction FltGetEcpListFromCallbackData (fltkernel.h)

Article
02/26/2024

La routine FltGetEcpListFromCallbackData retourne un pointeur vers une liste supplémentaire create parameter context structure (ECP) associée à un objet create callback-data donné.

Syntaxe

NTSTATUS FLTAPI FltGetEcpListFromCallbackData(
  [in]  PFLT_FILTER        Filter,
        PFLT_CALLBACK_DATA CallbackData,
  [out] PECP_LIST          *EcpList
);

Paramètres

[in] Filter

Pointeur de filtre opaque vers le pilote de minifiltre. Ce pointeur identifie de manière unique le pilote de minifiltre et reste constant tant que le pilote de minifiltre 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.

[out] EcpList

Reçoit un pointeur vers la liste ECP associée à l’objet callbackData callback-data.

Valeur retournée

FltGetEcpListFromCallbackData retourne l’une des valeurs NTSTATUS suivantes :

Code de retour	Description
STATUS_SUCCESS	EcpList a reçu un pointeur vers la liste ECP associée à l’objet de données de rappel donné. Si l’objet callback-data n’a pas d’ECP associé, STATUS_SUCCESS est retourné et EcpList a la valeur NULL.
STATUS_INVALID_PARAMETER	L’objet callback-data donné n’était pas une opération de création basée sur IRP. Dans ce cas, EcpList n’est pas défini.

Remarques

Pour attacher une liste ECP à un objet callback-data, utilisez la routine FltSetEcpListIntoCallbackData .

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