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 |
|---|---|
|
The given ECP list was successfully attached to the given callback-data object. |
|
The given callback data object was not an IRP-based create operation. |
|
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
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList
FltDeleteExtraCreateParameterLookasideList
FltFreeExtraCreateParameterList
FltGetNextExtraCreateParameter