FltGetVolumeContext-Funktion (fltkernel.h)

Artikel
02/26/2024

Die FltGetVolumeContext-Routine ruft einen Kontext ab, der von einem bestimmten Minifiltertreiber für ein Volume 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 wie der folgende zurückgegeben:

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Zu diesem Zeitpunkt wurde kein übereinstimmenden Kontext für diese Datei gefunden, sodass FltMgrKontext auf NULL_CONTEXT festgelegt hat. Dies ist ein Fehlercode.

Hinweise

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 durch Aufrufen von FltReleaseContext verringern. Daher muss jeder erfolgreiche Aufruf von FltGetVolumeContext durch einen nachfolgenden Aufruf von FltReleaseContext abgeglichen werden.

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

Um einen neuen Kontext zuzuordnen, rufen Sie FltAllocateContext auf.

Um einen Volumekontext zu löschen, rufen Sie FltDeleteVolumeContext oder FltDeleteContext auf.