Función FltGetVolumeFromFileObject (fltkernel.h)

Artículo
02/29/2024

La rutina FltGetVolumeFromFileObject devuelve un puntero opaco para el volumen en el que reside una secuencia de archivos determinada.

Sintaxis

NTSTATUS FLTAPI FltGetVolumeFromFileObject(
  [in]  PFLT_FILTER  Filter,
  [in]  PFILE_OBJECT FileObject,
  [out] PFLT_VOLUME  *RetVolume
);

Parámetros

[in] Filter

Puntero de filtro opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.

[in] FileObject

Puntero de objeto de archivo para una secuencia de archivos que reside en el volumen.

[out] RetVolume

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

Valor devuelto

FltGetVolumeFromFileObject devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_FLT_DELETING_OBJECT	El volumen se está derribando. Se trata de un código de error.
STATUS_INVALID_PARAMETER	No se encontró ningún volumen coincidente. Se trata de un código de error.

Comentarios

FltGetVolumeFromFileObject agrega una referencia de resumen al puntero de volumen opaco devuelto en el parámetro RetVolume . Cuando este puntero ya no es necesario, el autor de la llamada debe liberarlo llamando a FltObjectDereference. Por lo tanto, cada llamada correcta a FltGetVolumeFromFileObject debe coincidir con una llamada posterior a FltObjectDereference.

Para obtener un puntero al objeto de dispositivo para un volumen determinado, llame a FltGetDeviceObject.