FltGetNextExtraCreateParameter-Funktion (fltkernel.h)

Artikel
02/26/2024

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 einen ECP in der angegebenen ECP-Liste. Falls vorhanden, gibt FltGetNextExtraCreateParameter den ECP nach dem ECP currentEcpContext zurück. Wenn CurrentEcpContextNULL 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 der letzte ECP in der Liste, d.a. es gibt kein nächstes ECP-Listenelement). Darüber hinaus ist NextEcpContext auf NULL und NextEcpContextSize auf Null festgelegt.
STATUS_INVALID_PARAMETER	Der EcpList-Parameter ist NULL.

Hinweise

Diese Routine ist ab Windows Vista verfügbar.

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

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