FltCompareInstanceAltitudes-Funktion (fltkernel.h)

Artikel
02/06/2025

FltCompareInstanceAltitudes vergleicht die Höhen von zwei Minifiltertreiberinstanzen.

Syntax

LONG FLTAPI FltCompareInstanceAltitudes(
  [in] PFLT_INSTANCE Instance1,
  [in] PFLT_INSTANCE Instance2
);

Parameter

[in] Instance1

Zeiger auf die erste Instanz.

[in] Instance2

Zeiger auf die zweite Instanz.

Rückgabewert

FltCompareInstanceAltitudes gibt einen signierten Wert zurück, der die Ergebnisse des Vergleichs wie folgt liefert:

Rückgabecode	Beschreibung
Null-	Instance1- wird in derselben Höhe wie Instance2angefügt. Dies kann nur auftreten, wenn Instance1 und Instance2- an verschiedene Volumes angefügt sind oder wenn Instance1- und Instance2- Zeiger auf dieselbe Instanz sind.
Kleiner als null	Instance1- wird in einer niedrigeren Höhe als Instance2-angefügt.
Größer als Null	Instance1- wird in einer höheren Höhe als Instance2-angefügt.

Bemerkungen

Die Minifiltertreiberinstanzen, die Instanz1 und Instance2- verweisen, können Instanzen desselben Minifiltertreibers oder verschiedener Minifiltertreiber sein. Sie müssen jedoch an dasselbe Volume angefügt werden, wenn das von FltCompareInstanceAltitudes zurückgegebene Ergebnis sinnvoll ist.

Der Begriff "Höhe" bezieht sich auf die Position, die eine Instanz im Minifilter-Treiberinstanzstapel für ein Volume belegt (oder belegen sollte). Je höher die Höhe ist, desto weiter liegt die Instanz vom Basisdateisystem im Stapel. Auf einem bestimmten Volume kann nur eine Instanz in einer bestimmten Höhe angefügt werden.

Die Höhe wird durch eine Höhenzeichenfolgeangegeben, bei der es sich um eine gezählte Unicode-Zeichenfolge handelt, die aus einer oder mehreren Dezimalziffern von 0 bis 9 besteht; die Zeichenfolge kann einen einzelnen Dezimalkomma enthalten. 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, eine Instanz, deren Höhe "03333" ist, ist weiter vom Basisdateisystem entfernt als eine Instanz, deren Höhe "100.123456" lautet. Dieser Vergleich ist jedoch nur dann sinnvoll, wenn beide Instanzen mit demselben Volume verbunden sind.

Um eine Minifiltertreiberinstanz an ein Volume anzufügen, rufen Sie FltAttachVolume oder FltAttachVolumeAtAltitudeauf.

Rufen Sie FltDetachVolumeauf, um eine Minifiltertreiberinstanz von einem Volume zu trennen.