Partager via


Fonction FltGetEcpListFromCallbackData (fltkernel.h)

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

Voir aussi

ECP_LIST

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx