FltGetNextExtraCreateParameter-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetNextExtraCreateParameter Routine gibt einen Zeiger auf die nächste (oder erste) zusätzliche Create-Parameterkontextstruktur (ECP) in einer bestimmten ECP-Liste zurück.

Syntax

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

Parameter

[in] Filter

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

[in] EcpList

Zeiger auf die zu untersuchende ECP-Liste.

[in, optional] CurrentEcpContext

Optionaler Zeiger auf ein ECP in der angegebenen ECP-Liste. Wenn vorhanden, gibt FltGetNextExtraCreateParameter das ECP nach dem CurrentEcpContext- ECP zurück. Wenn CurrentEcpContext-NULL-ist, gibt FltGetNextExtraCreateParameter den ersten ECP in der Liste zurück.

[out, optional] NextEcpType

Optionaler Parameter, der einen Zeiger auf die GUID des zurückgegebenen ECP empfängt.

[out, optional] NextEcpContext

Optionaler Parameter, der einen Zeiger auf den zurückgegebenen ECP empfängt.

[out, optional] NextEcpContextSize

Optionaler Parameter, der die Größe des zurückgegebenen ECP in Bytes empfängt.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Ein ECP wurde in der EcpList ECP-Liste gefunden.
STATUS_NOT_FOUND	Die EcpList- ECP-Liste ist leer oder CurrentEcpContext ist das letzte ECP in der Liste, das heißt, es gibt kein nächstes ECP-Listenelement). Darüber hinaus wird NextEcpContext- auf NULL- und NextEcpContextSize- auf Null festgelegt.
STATUS_INVALID_PARAMETER	Der EcpList Parameter ist NULL.

Bemerkungen

Diese Routine ist ab Windows Vista verfügbar.

DieFltGetNextExtraCreateParameter Routine verarbeitet eine ECP-Liste auf nicht zirkuläre Weise. Das heißt, wenn das ECP, auf das das CurrentEcpContext Parameter verweist, das letzte ECP-Element in der ECP-Liste ist, gibt es keine "nächste" ECP in der Liste, und die Routine gibt STATUS_NOT_FOUND zurück.

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