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. |