FltReleaseContextsEx-Funktion (fltkernel.h)
FltReleaseContextsEx veröffentlicht jeden Kontext in einer bestimmten FLT_RELATED_CONTEXTS_EX Struktur.
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 durch Kontexteverweist. Auf Größe(FLT_RELATED_CONTEXTS_EX) festgelegt.
[in] Contexts
Zeigen Sie auf die FLT_RELATED_CONTEXTS_EX Struktur.
Rückgabewert
Nichts
Bemerkungen
Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.
FltReleaseContextsEx die Verweisanzahl auf alle Kontexte in der FLT_RELATED_CONTEXTS_EX Struktur erhöht und alle Elemente der Struktur auf NULL_CONTEXT festgelegt.
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 zur Kontextreferenzzählung finden Sie unter Verweisen auf Kontexte.
Aufrufer von FltReleaseContextsEx- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn alle Kontexte aus einem nicht seitengebundenen Pool zugewiesen wurden. Wenn Kontexte aus dem ausgelagerten Pool zugewiesen wurden, müssen Anrufer unter IRQL-<= APC_LEVEL ausgeführt werden.
Wenn die Referenzanzahl jedes Kontexts null erreicht, wird der Kontext sofort freigegeben, wenn der Aufrufer bei IRQL <= APC_LEVEL ausgeführt wird. Wenn der Aufrufer bei IRQL-DISPATCH_LEVEL ausgeführt wird, wird eine Arbeitsaufgabe so geplant, dass der Kontext freigegeben wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Zielplattform- | Universal |
| Header- | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL- | Fltmgr.sys |
| IRQL- | Siehe Abschnitt "Hinweise". |