FltInsertExtraCreateParameter function (fltkernel.h)

Article
02/22/2024

The FltInsertExtraCreateParameter routine inserts an extra create parameter (ECP) context structure into an ECP list.

Syntax

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Parameters

[in] Filter

Opaque filter pointer to the minifilter driver. This pointer uniquely identifies the minifilter driver and remains constant as long as the minifilter driver is loaded.

[in, out] EcpList

Pointer to the ECP list structure to which the ECP context structure, provided by the EcpContext parameter, should be added.

[in, out] EcpContext

Pointer to the ECP context structure to be added to the ECP list, provided by the EcpList parameter.

Return value

FltInsertExtraCreateParameter returns one of the following NTSTATUS values:

Return code	Description
STATUS_SUCCESS	The given ECP context structure was successfully inserted into the given ECP list.
STATUS_INVALID_PARAMETER	The given ECP context structure already exists in the given ECP list. In the context of ECP list insertion, two ECP context structures are considered to be identical if they contain equal GUID values.

Remarks

The FltInsertExtraCreateParameter routine assumes that the given ECP context structure to be inserted into the given ECP list was previously allocated by the FltAllocateExtraCreateParameter routine.

Each ECP context structure inserted into the ECP list must have a unique GUID value. This unique value is set when the ECP context structure is allocated by the FltAllocateExtraCreateParameter routine.

Requirements

Requirement	Value
Minimum supported client	This routine is available starting with Windows Vista.
Target Platform	Universal
Header	fltkernel.h (include Fltkernel.h)
Library	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL