FsRtlPrepareToReuseEcp function (ntifs.h)

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

Syntax

void FsRtlPrepareToReuseEcp(
  [in] PVOID EcpContext
);

Parameters

[in] EcpContext

A pointer to the ECP to prepare for reuse.

Return value

None

Remarks

The FsRtlPrepareToReuseEcp 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 FsRtlAcknowledgeEcp to mark the ECP as acknowledged. This indicates that the ECP was discovered and processed. To reuse an previously acknowledged ECP, such as in processing a reparse, a driver can use FsRtlPrepareToReuseEcp to clear the acknowledged state from the ECP before sending it in another create request.

Within a file system minifilter driver, use FltPrepareToReuseEcp to reuse an ECP.

Requirements

See also

ECP_LIST

FltPrepareToReuseEcp

FsRtlInsertExtraCreateParameter

FltIsEcpAcknowledged

FsRtlRemoveExtraCreateParameter