Export (0) Print
Expand All
Expand Minimize

FsRtlFindExtraCreateParameter routine

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_opt_  PVOID *EcpContext,
  _Out_opt_  ULONG *EcpContextSize
);

Parameters

EcpList [in]

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

EcpType [in]

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.

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 FsRtlFindExtraCreateParamter 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, EcpContextSize is set to zero.

Return value

FsRtlFindExtraCreateParameter returns one of the following NTSTATUS values:

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

Version

The FsRtlFindExtraCreateParameter routine is available starting with Windows Vista.

Header

Ntifs.h (include Ntifs.h)

Library

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