FltSetEcpListIntoCallbackData function (fltkernel.h)

The FltSetEcpListIntoCallbackData routine attaches an extra create parameter context structure (ECP) list to a create operation callback-data object.

Syntax

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

Parameters

[in] Filter

Opaque filter pointer to the minifilter driver. This pointer uniquely identifies the minifilter driver and remains constant as long as the minifilter driver is loaded.

CallbackData

Pointer to a callback-data object of type FLT_CALLBACK_DATA, which represents the create operation.

[in] EcpList

Pointer to the ECP list, which contains one or more ECPs, to be attached to the callback-data object.

Return value

FltSetEcpListIntoCallbackData returns one of the following NTSTATUS values:

Return code Description
STATUS_SUCCESS
The given ECP list was successfully attached to the given callback-data object.
STATUS_INVALID_PARAMETER_2
The given callback data object was not an IRP-based create operation.
STATUS_INVALID_PARAMETER_3
An ECP list has already been attached to the given callback-data object.

Remarks

The FltSetEcpListIntoCallbackData routine provides a mechanism for passing extra create parameters down the file system filter stack to underlying minifilter and legacy filter drivers.

To retrieve an attached ECP list from a given callback-data object, use the FltGetEcpListFromCallbackData routine.

Requirements

Requirement Value
Minimum supported client This routine is available starting with Windows Vista.
Target Platform Universal
Header fltkernel.h (include Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

See also

ECP_LIST

FLT_CALLBACK_DATA

FltAcknowledgeEcp

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FltFindExtraCreateParameter

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltGetNextExtraCreateParameter

FltInitExtraCreateParameterLookasideList

FltInsertExtraCreateParameter

FltIsEcpAcknowledged

FltIsEcpFromUserMode

FltRemoveExtraCreateParameter

IoCreateFileEx