Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
| Retourner le code | Description |
|---|---|
|
Instance1 est attaché à la même altitude que Instance2 . Cela peut se produire uniquement si Instance1 et Instance2 sont attachés à différents volumes ou si Instance1 et Instance2 sont des pointeurs vers la même instance. |
|
Instance1 est attachée à une altitude inférieure à Instance2. |
|
instance1 est attachée à une altitude supérieure à Instance2. |
Remarques
Les instances de pilote minifilter qui Instance1 et Instance2 point peuvent être des instances du même pilote minifilter ou des pilotes minifilter 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’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 d’un volume, appelez FltDetachVolume.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| IRQL | <= DISPATCH_LEVEL |