FltGetVolumeFromInstance-Funktion (fltkernel.h)

Artikel
02/06/2025

Die FltGetVolumeFromInstance Routine gibt einen undurchsichtigen Zeiger für das Volume zurück, an das eine angegebene Minifiltertreiberinstanz angefügt ist.

Syntax

NTSTATUS FLTAPI FltGetVolumeFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_VOLUME   *RetVolume
);

Parameter

[in] Instance

Undurchsichtiger Instanzzeiger für die Instanz.

[out] RetVolume

Zeiger auf eine vom Aufrufer zugewiesene Variable, die einen undurchsichtigen Zeiger für das Volume empfängt. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

Rückgabewert

FltGetVolumeFromInstance gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. folgendes:

Rückgabecode	Beschreibung
STATUS_FLT_DELETING_OBJECT	Das Volume, an das die Minifiltertreiberinstanz angefügt ist, wird heruntergerissen. Dies ist ein Fehlercode.

Bemerkungen

FltGetVolumeFromInstance fügt einen Rundownverweis auf den im RetVolume Parameter zurückgegebenen undurchsichtigen Volumezeiger hinzu. Wenn dieser Zeiger nicht mehr benötigt wird, muss der Aufrufer ihn freigeben, indem FltObjectDereferenceaufgerufen wird. Daher muss jeder erfolgreiche Aufruf von FltGetVolumeFromInstance mit einem nachfolgenden Aufruf von FltObjectDereferenceabgeglichen werden.

Rufen Sie FltGetFilterFromInstanceauf, um einen undurchsichtigen Filterzeiger für den Minifiltertreiber abzurufen, der eine bestimmte Instanz erstellt hat.

Rufen Sie FltGetDeviceObjectauf, um einen Zeiger auf das Geräteobjekt für ein bestimmtes Volume abzurufen.

Rufen Sie FltQueryVolumeInformationauf, um detaillierte Informationen über das Volume abzurufen, an das eine bestimmte Instanz angefügt ist.