FltSetEcpListIntoCallbackData function

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

Syntax

NTSTATUS FltSetEcpListIntoCallbackData(
  _In_ PFLT_FILTER        Filter,
  _In_ PFLT_CALLBACK_DATA Data,
  _In_ PECP_LIST          EcpList
);

Parameters

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

TBD

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

   
Windows version 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

FltAllocateExtraCreateParameterList

FltFindExtraCreateParameter

ECP_LIST

FltInitExtraCreateParameterLookasideList

FltGetEcpListFromCallbackData

FltAllocateExtraCreateParameter

FltGetNextExtraCreateParameter

IoCreateFileEx

FltAllocateExtraCreateParameterFromLookasideList

FltIsEcpAcknowledged

FltInsertExtraCreateParameter

FltAcknowledgeEcp

FltRemoveExtraCreateParameter

FltIsEcpFromUserMode

FltFreeExtraCreateParameterList

FltFreeExtraCreateParameter

FltCreateFileEx2

FltDeleteExtraCreateParameterLookasideList

FLT_CALLBACK_DATA

Send comments about this topic to Microsoft