Export (0) Print
Expand All
Expand Minimize

FltPrepareToReuseEcp routine

The FltPrepareToReuseEcp routine resets an extra create parameter (ECP) context structure, which prepares it for reuse.

Syntax


VOID FltPrepareToReuseEcp(
  _In_  PFLT_FILTER Filter,
  _In_  PVOID EcpContext
);

Parameters

Filter [in]

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.

EcpContext [in]

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

Version

Available starting with Windows 8.

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

<= APC_LEVEL

See also

ECP_LIST
FltGetEcpListFromCallbackData
FltlInsertExtraCreateParameter
FltIsEcpAcknowledged
FltRemoveExtraCreateParameter
FltSetEcpListIntoCallbackData

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft