Edit

FsRtlFindExtraCreateParameter function (ntifs.h)

  • Article

The FsRtlFindExtraCreateParameter 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 FsRtlFindExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out, optional] PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

Parameters

[in] EcpList

Pointer to the ECP list structure that FsRtlFindExtraCreateParameter uses to search for the ECP context structure, supplied by the EcpType parameter.

[in] EcpType

Pointer to a GUID that uniquely identifies the ECP context structure. This GUID value is used by the FsRtlFindExtraCreateParamter routine to determine if the ECP context structure exists in the ECP list, supplied by the EcpList parameter.

[out, optional] EcpContext

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 FsRtlFindExtraCreateParamter can be used to determine if the ECP context structure is in the ECP list.

[out, optional] EcpContextSize

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

Return value

FsRtlFindExtraCreateParameter returns one of the following NTSTATUS values:

Return code Description
STATUS_SUCCESS
 FsRtlFindExtraCreateParameter found the specified ECP context structure in the specified ECP list.
STATUS_NOT_FOUND
 FsRtlFindExtraCreateParameter didn't find the specified ECP context structure in the specified ECP list.

Requirements

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

See also

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx