FltFindExtraCreateParameter-Funktion (fltkernel.h)

Artikel
02/06/2025

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

Syntax

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger für den Minifiltertreiber. Dieser Zeiger identifiziert den Minifiltertreiber eindeutig und bleibt konstant, solange der Minifiltertreiber geladen wird.

[in] EcpList

Zeiger auf die ECP-Listenstruktur, in der nach der ECP-Kontextstruktur gesucht werden soll (angegeben durch den EcpType-Parameter).

[in] EcpType

Zeiger auf eine GUID, die jede ECP-Kontextstruktur eindeutig identifiziert. Dieser GUID-Wert wird vom FltFindExtraCreateParamter Routine verwendet, um zu ermitteln, ob die ECP-Kontextstruktur in der ECP-Liste vorhanden ist (angegeben durch den EcpList Parameter).

[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- vom Aufrufer auf NULL- festgelegt ist, kann der Rückgabewert dieser Routine verwendet werden, um festzustellen, 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 in der ECP-Liste nicht gefunden wird, wird EcpContextSize- auf Null festgelegt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die ECP-Kontextstruktur (wie durch den EcpType Parameter angegeben) wurde in der ECP-Liste gefunden (wie durch den EcpList Parameter angegeben).
STATUS_NOT_FOUND	Die ECP-Kontextstruktur (wie durch den EcpType Parameter angegeben) wurde in der ECP-Liste (wie durch den EcpList Parameter angegeben) nicht gefunden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Routine ist ab Windows Vista verfügbar.
Zielplattform-	Universal
Header-	fltkernel.h (include Fltkernel.h)
Library	FltMgr.lib
DLL-	Fltmgr.sys
IRQL-	<= APC_LEVEL