FltGetEcpListFromCallbackData, fonction (fltkernel.h)

Article
02/06/2025

La routine FltGetEcpListFromCallbackData retourne un pointeur vers une liste ecP (Create Parameter Context Structure) supplémentaire associée à un objet de rappel d’opération de création 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 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.

[out] EcpList

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

Valeur de retour

FltGetEcpListFromCallbackData retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	EcpList reçu un pointeur vers la liste ECP associée à l’objet de données de rappel donné. Si l’objet de rappel-données n’a pas d’environnement ECP associé, STATUS_SUCCESS est retourné et EcpList est NULL.
STATUS_INVALID_PARAMETER	L’objet de données de rappel 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 de données de rappel, utilisez la routine FltSetEcpListIntoCallbackData.

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