Fonction FltCompareInstanceAltitudes (fltkernel.h)

Article
02/26/2024

FltCompareInstanceAltitudes compare les altitudes de deux instances de pilotes de minifiltre.

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 retournée

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 l’instance2. Cela ne peut se produire que si Instance1 et Instance2 sont attachés à des volumes différents ou si Instance1 et Instance2 sont des pointeurs vers le même instance.
Inférieur à zéro	Instance1 est attachée à une altitude inférieure à l’instance2.
Supérieure à zéro	Instance1 est attachée à une altitude plus élevée que l’instance2.

Remarques

Les instances de pilote de minifiltre vers qui Pointe1 et Instance2 peuvent être des instances du même pilote de minifiltre ou de pilotes de minifiltre différents. Toutefois, elles doivent être attachées au même volume si le résultat retourné par FltCompareInstanceAltitudes doit être significatif.

Le terme « altitude » fait référence à la position qu’un instance occupe (ou doit occuper) dans le pilote minifiltre instance pile pour un volume. Plus l’altitude est élevée, plus le instance est éloigné du système de fichiers de base dans la pile. Un seul instance peut être attaché à 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 une décimale 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, un instance dont l’altitude est « 03333 » est plus éloigné du système de fichiers de base qu’un 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 un pilote minifiltre instance à un volume, appelez FltAttachVolume ou FltAttachVolumeAtAltitude.

Pour détacher un pilote minifiltre instance d’un volume, appelez FltDetachVolume.