Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

FsRtlPrepareToReuseEcp routine

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

Syntax


VOID FsRtlPrepareToReuseEcp(
  _In_  PVOID EcpContext
);

Parameters

EcpContext [in]

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

Version

Available starting with Windows 8.

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL

See also

ECP_LIST
FsRtlInsertExtraCreateParameter
FsRtlIsEcpAcknowledged
FltPrepareToReuseEcp
FsRtlRemoveExtraCreateParameter

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.