FltFreeExtraCreateParameter-Funktion (fltkernel.h)

Artikel
02/29/2024

Die FltFreeExtraCreateParameter-Routine gibt den Arbeitsspeicher für eine ECP-Kontextstruktur frei.

Syntax

VOID FLTAPI FltFreeExtraCreateParameter(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

Parameter

[in] Filter

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

[in] EcpContext

Zeiger auf die ecp-Kontextstruktur (extra create parameter), die freigegeben werden soll.

Rückgabewert

Keine.

Hinweise

Wenn die zu freigebende ECP-Kontextstruktur noch an eine ECP-Liste angefügt ist, muss sie zuerst von der FltRemoveExtraCreateParameter-Routine getrennt werden, bevor die FltFreeExtraCreateParameter-Routine aufgerufen werden kann, um sie frei zu machen.

Wenn eine Cleanup-Rückrufroutine vom Typ PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK für die angegebene ECP-Kontextstruktur definiert wurde, wird diese Rückrufroutine beim Löschen der ECP-Kontextstruktur aufgerufen. Weitere Informationen finden Sie unter PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK.

Anforderungen

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