FsRtlFindExtraCreateParameter-Funktion (ntifs.h)

Artikel
02/26/2024

Die FsRtlFindExtraCreateParameter-Routine durchsucht eine bestimmte ECP-Liste nach einer ECP-Kontextstruktur eines bestimmten Typs und gibt einen Zeiger auf diese Struktur zurück, wenn sie gefunden wird.

Syntax

NTSTATUS FsRtlFindExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out, optional] PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

Parameter

[in] EcpList

Zeiger auf die ECP-Listenstruktur, die FsRtlFindExtraCreateParameter verwendet, um nach der ECP-Kontextstruktur zu suchen, die vom EcpType-Parameter bereitgestellt wird.

[in] EcpType

Zeiger auf eine GUID, die die ECP-Kontextstruktur eindeutig identifiziert. Dieser GUID-Wert wird von der FsRtlFindExtraCreateParamter-Routine verwendet, um zu bestimmen, ob die ECP-Kontextstruktur in der ECP-Liste vorhanden ist, die vom EcpList-Parameter bereitgestellt wird.

[out, optional] EcpContext

Optionaler Parameter, der einen Zeiger auf die gefundene ECP-Kontextstruktur empfängt. Wenn die ECP-Kontextstruktur nicht in der ECP-Liste gefunden wird, wird EcpContext auf NULL festgelegt. Wenn EcpContext vom Aufrufer auf NULL festgelegt ist, kann der Rückgabewert von FsRtlFindExtraCreateParamter verwendet werden, um zu bestimmen, ob sich die ECP-Kontextstruktur in der ECP-Liste befindet.

[out, optional] EcpContextSize

Optionaler Parameter, der die Größe der gefundenen ECP-Kontextstruktur in Bytes empfängt. Wenn die ECP-Kontextstruktur nicht gefunden wird, wird EcpContextSize auf 0 festgelegt.

Rückgabewert

FsRtlFindExtraCreateParameter gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	FsRtlFindExtraCreateParameter hat die angegebene ECP-Kontextstruktur in der angegebenen ECP-Liste gefunden.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter hat die angegebene ECP-Kontextstruktur in der angegebenen ECP-Liste nicht gefunden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Die FsRtlFindExtraCreateParameter-Routine ist ab Windows Vista verfügbar.
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL