Funzione FltCompareInstanceAltitudes (fltkernel.h)

Articolo
02/06/2025

FltCompareInstanceAltitudes confronta le altitudini di due istanze del driver minifiltro.

Sintassi

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

Parametri

[in] Instance1

Puntatore alla prima istanza.

[in] Instance2

Puntatore alla seconda istanza.

Valore restituito

FltCompareInstanceAltitudes restituisce un valore con segno che fornisce i risultati del confronto nel modo seguente:

Codice restituito	Descrizione
zero	Instance1 è collegato alla stessa altitudine di Instance2. Ciò può verificarsi solo se Instance1 e Instance2 sono collegati a volumi diversi o se Instance1 e Instance2 sono puntatori alla stessa istanza.
Minore di zero	Instance1 è collegato a un'altitudine inferiore a Instance2.
maggiore di zero	Instance1 è collegato a un'altitudine superiore a Instance2.

Osservazioni

Le istanze del driver minifiltro che Instance1 e Instance2 possono essere istanze dello stesso driver minifiltro o driver minifiltro diversi. Tuttavia, devono essere collegati allo stesso volume se il risultato restituito da FltCompareInstanceAltitudes deve essere significativo.

Il termine "altitudine" si riferisce alla posizione occupata da un'istanza (o deve occupare) nello stack di istanze del driver minifilter per un volume. Maggiore è l'altitudine, più lontana è l'istanza dal file system di base nello stack. Una sola istanza può essere collegata a una determinata altitudine su un determinato volume.

L'altitudine viene specificata da una stringa di altitudine , ovvero una stringa Unicode con conteggiata costituita da una o più cifre decimali da 0 a 9; la stringa può includere un singolo separatore decimale. Ad esempio, "100.123456" e "03333" sono stringhe di altitudine valide.

La stringa "03333" rappresenta un'altitudine superiore a "100.123456" (gli zeri iniziali e finali vengono ignorati). In altre parole, un'istanza la cui altitudine è "03333" è più lontana dal file system di base rispetto a un'istanza la cui altitudine è "100,123456". Tuttavia, questo confronto è significativo solo se entrambe le istanze sono collegate allo stesso volume.

Per collegare un'istanza del driver minifilter a un volume, chiamare FltAttachVolume o FltAttachVolumeAtAltitude.

Per scollegare un'istanza del driver minifilter da un volume, chiamare FltDetachVolume.