Funzione FltCompareInstanceAltitudes (fltkernel.h)

Articolo
02/26/2024

FltCompareInstanceAltitudes confronta le altitudini di due istanze del driver minifilter.

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 firmato che fornisce i risultati del confronto come indicato di seguito:

Codice restituito	Descrizione
Zero	Instance1 è collegato con la 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.

Commenti

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

Il termine "altitudine" fa riferimento alla posizione che un'istanza occupa (o deve occupare) nello stack di istanze del driver minifilter per un volume. Maggiore è l'altitudine, più lontano l'istanza è dal file system di base nello stack. È possibile collegare un'unica istanza a una determinata altitudine in un determinato volume.

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

La stringa "03333" rappresenta un'altitudine superiore a "100.123456" (gli zero 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 associate 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.