UID

title

description

old-location

tech.root

ms.date

keywords

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

f1_keywords

topic_type

api_type

api_location

api_name

NF:fltkernel.FltFindExtraCreateParameter

FltFindExtraCreateParameter function (fltkernel.h)

The FltFindExtraCreateParameter routine searches a given ECP list for an ECP context structure of a given type and returns a pointer to this structure if it is found.

ifsk\fltfindextracreateparameter.htm

ifsk

04/16/2018

FltFindExtraCreateParameter function

FltApiRef_e_to_o_6f7f8d49-a0b3-4a32-9a51-d31ab84baf8a.xml, FltFindExtraCreateParameter, FltFindExtraCreateParameter routine [Installable File System Drivers], fltkernel/FltFindExtraCreateParameter, ifsk.fltfindextracreateparameter

fltkernel.h

Fltkernel.h

Universal

This routine is available starting with Windows Vista.

FltMgr.lib

Fltmgr.sys

<= APC_LEVEL

Windows

FltFindExtraCreateParameter

fltkernel/FltFindExtraCreateParameter

APIRef

kbSyntax

DllExport

fltmgr.sys

FltFindExtraCreateParameter

FltFindExtraCreateParameter function

-description

The FltFindExtraCreateParameter routine searches a given ECP list for an ECP context structure of a given type and returns a pointer to this structure if it is found.

-parameters

-param Filter [in]

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

-param EcpList [in]

Pointer to the ECP list structure in which to search for the ECP context structure (given by the EcpType parameter).

-param EcpType [in]

Pointer to a GUID that uniquely identifies each ECP context structure. This GUID value is used by the FltFindExtraCreateParamter routine to determine if the ECP context structure exists in the ECP list (given by the EcpList parameter).

-param EcpContext [out, optional]

Optional parameter that receives a pointer to the found ECP context structure. If the ECP context structure is not found in the ECP list, EcpContext is set to NULL. If EcpContext is set to NULL by the caller, the return value of this routine can be used to determine if the ECP context structure is in the ECP list.

-param EcpContextSize [out, optional]

Optional parameter that receives the size, in bytes, of the found ECP context structure. If the ECP context structure is not found in the ECP list, EcpContextSize is set to zero.

-returns

FltFindExtraCreateParameter returns one of the following NTSTATUS values:

Return code	Description
STATUS_SUCCESS	The ECP context structure (as specified by the EcpType parameter) was found in the ECP list (as specified by the EcpList parameter).
STATUS_NOT_FOUND	The ECP context structure (as specified by the EcpType parameter) was not found in the ECP list (as specified by the EcpList parameter).