FltGetVolumeContext-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetVolumeContext Routine ruft einen Kontext ab, der für ein Volume durch einen bestimmten Minifiltertreiber festgelegt wurde.

Syntax

NTSTATUS FLTAPI FltGetVolumeContext(
  [in]  PFLT_FILTER  Filter,
  [in]  PFLT_VOLUME  Volume,
  [out] PFLT_CONTEXT *Context
);

Parameter

[in] Filter

Undurchsichtiger Filterzeiger für den Aufrufer. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] Volume

Undurchsichtiger Zeiger für das Volume, dessen Kontext abgerufen wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[out] Context

Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des angeforderten Kontexts empfängt. Dieser Parameter ist erforderlich und kann nicht auf NULL festgelegt werden.

Rückgabewert

FltGetVolumeContext- gibt STATUS_SUCCESS zurück, wenn der angeforderte Kontext erfolgreich zurückgegeben wird. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben, z. B. folgendes:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Derzeit wurde in dieser Datei kein Abgleichskontext gefunden, sodass FltMgrContext auf NULL_CONTEXT festlegen. Dies ist ein Fehlercode.

Bemerkungen

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

FltGetVolumeContext erhöht die Verweisanzahl für den Kontext, auf den der Context-Parameter verweist. Wenn dieser Kontextzeiger nicht mehr benötigt wird, muss der Aufrufer seine Verweisanzahl erhöhen, indem FltReleaseContext-aufgerufen wird. Daher muss jeder erfolgreiche Aufruf von FltGetVolumeContext durch einen nachfolgenden Aufruf von FltReleaseContextabgeglichen werden.

Um einen Kontext für ein Volume festzulegen, rufen Sie FltSetVolumeContextauf.

Rufen Sie FltAllocateContextauf, um einen neuen Kontext zuzuweisen.

Rufen Sie zum Löschen eines Volumekontexts FltDeleteVolumeContext oder FltDeleteContext-auf.