Función FltCompareInstanceAltitudes (fltkernel.h)

Artículo
08/07/2023

FltCompareInstanceAltitudes compara las altitudes de dos instancias de controlador de minifiltro.

Sintaxis

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

Parámetros

[in] Instance1

Puntero a la primera instancia.

[in] Instance2

Puntero a la segunda instancia.

Valor devuelto

FltCompareInstanceAltitudes devuelve un valor con signo que proporciona los resultados de la comparación de la siguiente manera:

Código devuelto	Descripción
Cero	Instance1 se adjunta a la misma altitud que Instance2. Esto solo puede ocurrir si Instance1 e Instance2 están asociados a volúmenes diferentes o si Instance1 e Instance2 son punteros a la misma instancia.
Menor que cero	Instance1 se adjunta a una altitud inferior a Instance2.
Mayor que cero	Instance1 se adjunta a una altitud mayor que Instance2.

Comentarios

Las instancias de controlador de minifiltro a las que apunta Instance1 e Instance2 pueden ser instancias del mismo controlador de minifiltro o de diferentes controladores de minifiltro. Sin embargo, deben asociarse al mismo volumen si el resultado devuelto por FltCompareInstanceAltitudes debe ser significativo.

El término "altitud" hace referencia a la posición que ocupa una instancia (o debe ocupar) en la pila de instancias del controlador de minifiltro para un volumen. Cuanto mayor sea la altitud, más lejos será la instancia del sistema de archivos base de la pila. Solo se puede adjuntar una instancia a una altitud determinada en un volumen determinado.

La altitud se especifica mediante una cadena de altitud, que es una cadena Unicode con recuento que consta de uno o más dígitos decimales de 0 a 9; la cadena puede incluir un único separador decimal. Por ejemplo, "100.123456" y "03333" son cadenas de altitud válidas.

La cadena "03333" representa una altitud mayor que "100.123456" (se omiten los ceros iniciales y finales). En otras palabras, una instancia cuya altitud es "03333" está más lejos del sistema de archivos base que una instancia cuya altitud es "100.123456". Sin embargo, esta comparación solo es significativa si ambas instancias están asociadas al mismo volumen.

Para adjuntar una instancia de controlador de minifiltro a un volumen, llame a FltAttachVolume o FltAttachVolumeAtAltitude.

Para desasociar una instancia de controlador de minifiltro de un volumen, llame a FltDetachVolume.