Función FltGetBottomInstance (fltkernel.h)

Artículo
02/26/2024

FltGetBottomInstance devuelve un puntero de instancia opaco para la instancia del controlador de minifiltro, si hay uno, que se adjunta en la parte inferior de la pila de instancias de un volumen determinado.

Sintaxis

NTSTATUS FLTAPI FltGetBottomInstance(
  [in]  PFLT_VOLUME   Volume,
  [out] PFLT_INSTANCE *Instance
);

Parámetros

[in] Volume

Puntero opaco para el volumen.

[out] Instance

Puntero a una variable asignada por el autor de la llamada que recibe un puntero de instancia opaco para la instancia inferior de este volumen. Este parámetro es obligatorio y no puede ser NULL.

Valor devuelto

FltGetBottomInstance devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Código devuelto	Descripción
STATUS_NO_MORE_ENTRIES	No se encontró ninguna instancia coincidente. Se trata de un código de advertencia.

Comentarios

Se dice que una instancia está en la parte inferior de la pila de instancias del controlador de minifiltro si su altitud es inferior a la de todas las demás instancias asociadas al mismo volumen. El término "altitud" hace referencia a la posición que ocupa una instancia en la pila de instancias del controlador de minifiltro para un volumen. Cuanto mayor sea la altitud, más lejos estará la instancia del sistema de archivos base en 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, y 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.

FltGetBottomInstance agrega una referencia de rundown al puntero de instancia opaco devuelto en *Instance. Cuando este puntero ya no es necesario, el autor de la llamada debe liberarlo llamando a FltObjectDereference. Por lo tanto, cada llamada correcta a FltGetBottomInstance debe coincidir con una llamada posterior a FltObjectDereference.