FsRtlFindExtraCreateParameter function (ntifs.h)
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 |
|---|---|
|
FsRtlFindExtraCreateParameter found the specified ECP context structure in the specified ECP list. |
|
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
FltAllocateExtraCreateParameterFromLookasideList