FltInsertExtraCreateParameter-Funktion (fltkernel.h)

Artikel
03/01/2024

Die FltInsertExtraCreateParameter-Routine fügt eine ECP-Kontextstruktur (Extra Create Parameter) in eine ECP-Liste ein.

Syntax

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

Parameter

[in] Filter

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

[in, out] EcpList

Zeiger auf die ECP-Listenstruktur, der die ECP-Kontextstruktur hinzugefügt werden soll, die vom EcpContext-Parameter bereitgestellt wird.

[in, out] EcpContext

Zeiger auf die ECP-Kontextstruktur, die der ECP-Liste hinzugefügt werden soll, die vom EcpList-Parameter bereitgestellt wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die angegebene ECP-Kontextstruktur wurde erfolgreich in die angegebene ECP-Liste eingefügt.
STATUS_INVALID_PARAMETER	Die angegebene ECP-Kontextstruktur ist bereits in der angegebenen ECP-Liste vorhanden. Im Kontext der ECP-Listeneinfügung gelten zwei ECP-Kontextstrukturen als identisch, wenn sie gleiche GUID-Werte enthalten.

Hinweise

Die FltInsertExtraCreateParameter-Routine geht davon aus, dass die angegebene ECP-Kontextstruktur, die in die angegebene ECP-Liste eingefügt werden soll, zuvor von der FltAllocateExtraCreateParameter-Routine zugeordnet wurde.

Jede ECP-Kontextstruktur, die in die ECP-Liste eingefügt wird, muss über einen eindeutigen GUID-Wert verfügen. Dieser eindeutige Wert wird festgelegt, wenn die ECP-Kontextstruktur von der FltAllocateExtraCreateParameter-Routine zugeordnet wird.

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