FsRtlFindExtraCreateParameter-Funktion (ntifs.h)

Artikel
12/21/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

Zeigen Sie auf eine GUID, die die ECP-Kontextstruktur eindeutig identifiziert. Dieser GUID-Wert wird vom FsRtlFindExtraCreateParamter Routine verwendet, um zu ermitteln, 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 in der ECP-Liste nicht gefunden wird, wird EcpContext- auf NULL-festgelegt. Wenn EcpContext- auf NULL- durch den Aufrufer 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 Null festgelegt.

Rückgabewert

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Die FsRtlFindExtraCreateParameter-Routine ist ab Windows Vista verfügbar.
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL