FsRtlSetEcpListIntoIrp function (ntifs.h)

Article
02/22/2024

The FsRtlSetEcpListIntoIrp routine attaches an extra create parameter (ECP) context structure list to an IRP_MJ_CREATE operation.

Syntax

NTSTATUS FsRtlSetEcpListIntoIrp(
  [in, out] PIRP      Irp,
  [in]      PECP_LIST EcpList
);

Parameters

[in, out] Irp

A pointer to the IRP for an IRP_MJ_CREATE operation to which the ECP context structure list is to be attached.

[in] EcpList

Pointer to an ECP list that contains one or more ECP context structures. These structures will be attached to the IRP to which the Irp parameter points.

Return value

FsRtlSetEcpListIntoIrp returns one of the following NTSTATUS values:

Return code	Description
STATUS_SUCCESS	The given ECP list was successfully attached to the given IRP.
STATUS_INVALID_PARAMETER_2	The given IRP was not an IRP-based IRP_MJ_CREATE operation.
STATUS_INVALID_PARAMETER_3	An ECP list has already been attached to the given IRP.

Remarks

The FsRtlSetEcpListIntoIrp routine provides a mechanism for passing extra create parameters down the file system filter stack to underlying filter drivers.

To retrieve an ECP list that is associated with a given IRP_MJ_CREATE operation, use the FsRtlGetEcpListFromIrp routine.

Requirements

Requirement	Value
Minimum supported client	FsRtlSetEcpListIntoIrp is available starting with Windows Vista.
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL