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 |