FltFindExtraCreateParameter-Funktion (fltkernel.h)

Artikel
03/01/2024

Die FltFindExtraCreateParameter-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 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 (angegeben durch den EcpType-Parameter ) gesucht werden soll.

[in] EcpType

Zeiger auf eine GUID, die jede ECP-Kontextstruktur eindeutig identifiziert. Dieser GUID-Wert wird von der FltFindExtraCreateParamter-Routine verwendet, um zu bestimmen, 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 nicht in der ECP-Liste gefunden wird, wird EcpContext auf NULL festgelegt. Wenn EcpContext vom Aufrufer auf NULL festgelegt wird, kann der Rückgabewert dieser Routine verwendet werden, um zu bestimmen, ob die ECP-Kontextstruktur in der ECP-Liste enthalten ist.

[out, optional] EcpContextSize

Optionaler Parameter, der die Größe der gefundenen ECP-Kontextstruktur in Bytes empfängt. Wenn die ECP-Kontextstruktur nicht in der ECP-Liste gefunden wird, wird EcpContextSize auf 0 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 nicht in der ECP-Liste gefunden (wie durch den EcpList-Parameter angegeben).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Routine ist ab Windows Vista verfügbar.
Zielplattform	Universell
Header	fltkernel.h (include Fltkernel.h)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL