Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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