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

See also

ECP_LIST

FltGetEcpListFromCallbackData

FltIsEcpAcknowledged

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

FltlInsertExtraCreateParameter