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

FsRtlSetEcpListIntoIrp routine

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

Syntax


NTSTATUS FsRtlSetEcpListIntoIrp(
  _Inout_  PIRP Irp,
  _In_     PECP_LIST EcpList
);

Parameters

Irp [in, out]

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

EcpList [in]

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

Version

FsRtlSetEcpListIntoIrp is available starting with Windows Vista.

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL

See also

ECP_LIST
FsRtlGetEcpListFromIrp

 

 

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.