FltGetBottomInstance-Funktion (fltkernel.h)

Artikel
02/26/2024

FltGetBottomInstance gibt einen undurchsichtigen instance-Zeiger für den Minifiltertreiber instance zurück, der am unteren Rand des instance-Stapels für ein bestimmtes Volume angefügt ist.

Syntax

NTSTATUS FLTAPI FltGetBottomInstance(
  [in]  PFLT_VOLUME   Volume,
  [out] PFLT_INSTANCE *Instance
);

Parameter

[in] Volume

Undurchsichtiger Zeiger für das Volume.

[out] Instance

Zeiger auf eine vom Aufrufer zugewiesene Variable, die einen undurchsichtigen instance-Zeiger für den unteren instance für dieses Volume empfängt. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

FltGetBottomInstance gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert wie den folgenden zurück:

Rückgabecode	Beschreibung
STATUS_NO_MORE_ENTRIES	Es wurde kein übereinstimmende instance gefunden. Dies ist ein Warncode.

Hinweise

Ein instance soll sich am unteren Rand des Minifiltertreibers instance Stapels befinden, wenn seine Höhe niedriger ist als die aller anderen Instanzen, die an dasselbe Volume angefügt sind. Der Begriff "Höhe" bezieht sich auf die Position, die ein instance im Minifiltertreiber instance Stapel für ein Volume einnimmt. Je höher die Höhe, desto weiter ist die instance aus dem Basisdateisystem im Stapel. Nur eine instance kann in einer bestimmten Höhe auf einem bestimmten Volumen angebracht werden.

Die Höhe wird durch eine Höhenzeichenfolge angegeben, bei der es sich um eine gezählte Unicode-Zeichenfolge handelt, die aus einer oder mehreren Dezimalstellen von 0 bis 9 besteht und einen einzelnen Dezimalpunkt enthalten kann. Beispielsweise sind "100.123456" und "03333" gültige Höhenzeichenfolgen.

Die Zeichenfolge "03333" stellt eine höhere Höhe als "100,123456" dar. (Führende und nachfolgende Nullen werden ignoriert.) Mit anderen Worten, ein instance dessen Höhe "0333" ist, ist weiter vom Basisdateisystem entfernt als ein instance dessen Höhe "100,123456" ist. Dieser Vergleich ist jedoch nur sinnvoll, wenn beide Instanzen an dasselbe Volume angefügt sind.

FltGetBottomInstance fügt einen Rundownverweis zum in *Instance zurückgegebenen undurchsichtigen instance-Zeiger hinzu. Wenn dieser Zeiger nicht mehr benötigt wird, muss der Aufrufer ihn freigeben, indem er FltObjectDereference aufruft. Daher muss jeder erfolgreiche Aufruf von FltGetBottomInstance durch einen nachfolgenden Aufruf von FltObjectDereference abgeglichen werden.