FltSetEcpListIntoCallbackData
TOC
Collapse the table of content
Expand the table of content

FltSetEcpListIntoCallbackData routine

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 [in]

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.

Data [in]

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

EcpList [in]

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 codeDescription
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

Target platform

Universal

Version

This routine is available starting with Windows Vista.

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

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft