FltCompareInstanceAltitudes, fonction (fltkernel.h)

FltCompareInstanceAltitudes compare les altitudes de deux instances de pilote minifilter.

Syntaxe

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

Paramètres

[in] Instance1

Pointeur vers la première instance.

[in] Instance2

Pointeur vers la deuxième instance.

Valeur de retour

FltCompareInstanceAltitudes retourne une valeur signée qui donne les résultats de la comparaison comme suit :

Code de retour Description
Zéro
Instance1 est attachée à la même altitude que Instance2. Cela ne peut se produire que si Instance1 et Instance2 sont attachés à différents volumes ou si Instance1 et Instance2 sont des pointeurs vers la même instance.
Inférieur à zéro
Instance1 est attachée à une altitude inférieure à Instance2.
Supérieure à zéro
Instance1 est attachée à une altitude supérieure à Instance2.

Remarques

Les instances de pilote minifilter que pointent Instance1 et Instance2 peuvent être des instances du même pilote minifilter ou des pilotes de minifilter différents. Toutefois, ils doivent être attachés au même volume si le résultat retourné par FltCompareInstanceAltitudes doit être significatif.

Le terme « altitude » fait référence à la position qu’une instance occupe (ou doit occuper) dans la pile d’instances de pilote minifilter pour un volume. Plus l’altitude est élevée, plus l’instance provient du système de fichiers de base dans la pile. Une seule instance peut être attachée à une altitude donnée sur un volume donné.

L’altitude est spécifiée par une chaîne d’altitude, qui est une chaîne Unicode comptée qui se compose d’un ou plusieurs chiffres décimaux de 0 à 9 ; la chaîne peut inclure un point décimal unique. Par exemple, « 100.123456 » et « 03333 » sont des chaînes d’altitude valides.

La chaîne « 03333 » représente une altitude supérieure à « 100,123456 » (les zéros de début et de fin sont ignorés.) En d’autres termes, une instance dont l’altitude est « 03333 » est plus éloignée du système de fichiers de base qu’une instance dont l’altitude est « 100.123456 ». Toutefois, cette comparaison n’est significative que si les deux instances sont attachées au même volume.

Pour attacher une instance de pilote minifilter à un volume, appelez FltAttachVolume ou FltAttachVolumeAtAltitude.

Pour détacher une instance de pilote minifilter à partir d’un volume, appelez FltDetachVolume.

Configuration requise

   
Plateforme cible Universal
En-tête fltkernel.h (include Fltkernel.h)
Bibliothèque FltMgr.lib
IRQL <= DISPATCH_LEVEL

Voir aussi

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltDetachVolume