FltPrepareToReuseEcp function (fltkernel.h)
The FltPrepareToReuseEcp routine resets an extra create parameter (ECP) context structure, which prepares it for reuse.
Syntax
VOID FLTAPI FltPrepareToReuseEcp(
[in] PFLT_FILTER Filter,
[in] PVOID EcpContext
);
Parameters
[in] Filter
An opaque filter pointer for the minifilter driver. This pointer uniquely identifies the minifilter driver and remains constant as long as the minifilter driver is loaded.
[in] EcpContext
A pointer to the ECP to prepare for reuse.
Return value
None.
Remarks
The FltPrepareToReuseEcp allows reuse of an ECP used in a previous create request. This prevents having to initialize a new ECP with the same information.
The target of an ECP uses FltAcknowledgeEcp to mark the ECP as acknowledged. This indicates that the ECP was discovered and processed. To reuse a previously acknowledged ECP, such as in processing a reparse, a driver can use FltPrepareToReuseEcp to clear the acknowledged state from the ECP before sending it in another create request.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available starting with Windows 8. |
| Target Platform | Universal |
| Header | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |