FltReleaseContextsEx-Funktion (fltkernel.h)

FltReleaseContextsEx gibt jeden Kontext in einer bestimmten FLT_RELATED_CONTEXTS_EX-Struktur frei.

Syntax

VOID FLTAPI FltReleaseContextsEx(
  [in] SIZE_T                   ContextsSize,
  [in] PFLT_RELATED_CONTEXTS_EX Contexts
);

Parameter

[in] ContextsSize

Die Größe der FLT_RELATED_CONTEXTS_EX Struktur in Bytes, auf die von Kontexten verwiesen wird. Auf sizeof(FLT_RELATED_CONTEXTS_EX) festgelegt.

[in] Contexts

Zeiger auf die FLT_RELATED_CONTEXTS_EX-Struktur .

Rückgabewert

Keine

Bemerkungen

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

FltReleaseContextsEx dekrementiert die Verweisanzahl für alle Kontexte in der FLT_RELATED_CONTEXTS_EX-Struktur und legt alle Member der Struktur auf NULL_CONTEXT fest.

Rufen Sie FltGetContextsEx auf, um die FLT_RELATED_CONTEXTS_EX-Struktur für einen bestimmten Minifiltertreiber für eine bestimmte E/A-Anforderung abzurufen.

Weitere Informationen zum Zählen von Kontextreferenzen finden Sie unter Verweisen auf Kontexte.

Aufrufer von FltReleaseContextsEx müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn alle Kontexte aus einem nicht ausseitigen Pool zugeordnet wurden. Wenn Kontexte aus einem Auslagerungspool zugeordnet wurden, müssen Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.

Wenn die Verweisanzahl jedes Kontexts null erreicht, wird der Kontext sofort freigegeben, wenn der Aufrufer unter IRQL <= APC_LEVEL ausgeführt wird. Wenn der Aufrufer unter IRQL DISPATCH_LEVEL ausgeführt wird, wird ein Arbeitselement zum Freigeben des Kontexts geplant.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	fltkernel.h (fltkernel.h einschließen)
Bibliothek	FltMgr.lib
DLL	Fltmgr.sys
IRQL	Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Weitere Informationen

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext