Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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 a 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

Requirement Value
Minimum supported client Windows 8
Target Platform Universal
Header ntifs.h (include Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

ECP_LIST

FltPrepareToReuseEcp

FsRtlInsertExtraCreateParameter

FltIsEcpAcknowledged

FsRtlRemoveExtraCreateParameter


Feedback

Was this page helpful?

Additional resources