Expand Minimize

FltFindExtraCreateParameter routine

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.

Syntax


NTSTATUS FltFindExtraCreateParameter(
  _In_       PFLT_FILTER Filter,
  _In_       PECP_LIST EcpList,
  _In_       LPCGUID EcpType,
  _Out_opt_  PVOID *EcpContext,
  _Out_opt_  ULONG *EcpContextSize
);

Parameters

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.

EcpList [in]

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

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).

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.

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.

Return value

FltFindExtraCreateParameter returns one of the following NTSTATUS values:

Return codeDescription
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).

 

Requirements

Version

This routine is available starting with Windows Vista.

Header

Fltkernel.h (include Fltkernel.h)

Library

FltMgr.lib

IRQL

<= APC_LEVEL

See also

ECP_LIST
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterFromLookasideList
FltCreateFileEx2
FltInsertExtraCreateParameter
FltFreeExtraCreateParameter
FltGetEcpListFromCallbackData
FltRemoveExtraCreateParameter
FltSetEcpListIntoCallbackData
IoCreateFileEx

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft