FltCompareInstanceAltitudes-Funktion (fltkernel.h)

Artikel
02/29/2024

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 den ersten instance.

[in] Instance2

Zeiger auf den zweiten instance.

Rückgabewert

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

Rückgabecode	Beschreibung
Zero	Instanz1 wird in derselben Höhe wie Instance2 angefügt. Dies kann nur auftreten, wenn Instance1 und Instance2 an unterschiedliche Volumes angefügt sind oder wenn Instance1 und Instance2 zeiger auf dieselbe instance sind.
Kleiner als 00	Instanz1 wird in einer niedrigeren Höhe als Instance2 angefügt.
Größer als 0 (null)	Instance1 wird in einer höheren Höhe als Instance2 angefügt.

Hinweise

Die Minifiltertreiberinstanzen, auf die Instance1 und Instance2 verweisen, können Instanzen desselben Minifiltertreibers oder anderer Minifiltertreiber sein. Sie müssen jedoch an dasselbe Volume angefügt werden, wenn das von FltCompareInstanceAltitudes zurückgegebene Ergebnis aussagekräftig sein soll.

Der Begriff "Höhe" bezieht sich auf die Position, die ein instance im Minifiltertreiber instance Stapels für ein Volume einnimmt (oder belegen sollte). 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; die Zeichenfolge kann einen einzelnen Dezimalpunkt 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, 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.

Um einen Minifiltertreiber instance an ein Volume anzufügen, rufen Sie FltAttachVolume oder FltAttachVolumeAtAltitude auf.

Um einen Minifiltertreiber instance von einem Volume zu trennen, rufen Sie FltDetachVolume auf.