FltDeleteStreamContext-Funktion (fltkernel.h)

Artikel
02/06/2025

FltDeleteStreamContext entfernt einen Kontext, den eine bestimmte Minifiltertreiberinstanz für einen bestimmten Datenstrom festgelegt hat, und markiert den Kontext für das Löschen.

Syntax

NTSTATUS FLTAPI FltDeleteStreamContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für die Minifiltertreiberinstanz, deren Kontext aus der Liste der kontextgebundenen Kontexte entfernt werden soll, die dem Dateidatenstrom zugeordnet sind.

[in] FileObject

Zeigen Sie auf ein Dateiobjekt für den Dateidatenstrom.

[out] OldContext

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des gelöschten Kontexts empfängt. Dieser Parameter ist optional und kann NULL-werden. Wenn OldContext- nicht NULL- ist und nicht auf NULL_CONTEXT verweist, ist der Aufrufer für das Aufrufen FltReleaseContext verantwortlich, um diesen Kontext freizugeben, wenn er nicht mehr benötigt wird.

Rückgabewert

FltDeleteStreamContext gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_FLT_DELETING_OBJECT	Die angegebene Instanz- wird heruntergerissen. Dies ist ein Fehlercode.
STATUS_NOT_FOUND	Es wurde kein übereinstimmenden Kontext gefunden. Dies ist ein Fehlercode.
STATUS_NOT_SUPPORTED	Das Dateisystem unterstützt keine Datenstromkontexte für diesen Dateidatenstrom. Dies ist ein Fehlercode.

Bemerkungen

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

Da Kontexte referenziert werden, ist es in der Regel nicht erforderlich, dass ein Minifiltertreiber eine Routine aufruft, z. B. FltDeleteStreamContext, um einen Kontext explizit zu löschen.

Ein Minifiltertreiber ruft FltDeleteStreamContext- auf, um einen Kontext aus einem Dateidatenstrom zu entfernen und den Kontext für das Löschen zu markieren. Der Kontext wird in der Regel sofort freigegeben, es sei denn, es gibt einen ausstehenden Verweis darauf (z. B. weil der Kontext noch von einem anderen Thread verwendet wird).

Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.

Rufen Sie FltGetStreamContextauf, um einen Streamkontext abzurufen.

Rufen Sie zum Festlegen eines Datenstromkontexts FltSetStreamContextauf.