Función FltQueryVolumeInformationFile (fltkernel.h)

Artículo
02/29/2024

FltQueryVolumeInformationFile recupera información de volumen de un archivo, directorio, dispositivo de almacenamiento o volumen determinado.

Sintaxis

NTSTATUS FLTAPI FltQueryVolumeInformationFile(
  [in]            PFLT_INSTANCE        Instance,
  [in]            PFILE_OBJECT         FileObject,
  [out]           PVOID                FsInformation,
  [in]            ULONG                Length,
  [in]            FS_INFORMATION_CLASS FsInformationClass,
  [out, optional] PULONG               LengthReturned
);

Parámetros

[in] Instance

Puntero de instancia 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 un archivo abierto, directorio, dispositivo de almacenamiento o volumen. Este parámetro es obligatorio y no puede ser NULL.

[out] FsInformation

Puntero a un búfer asignado por el autor de la llamada que recibe información sobre el archivo. El parámetro FsInformationClass especifica el tipo de información. Este parámetro es obligatorio y no puede ser NULL.

[in] Length

Tamaño, en bytes, del búfer FsInformation .

[in] FsInformationClass

Tipo de información de volumen que se va a devolver. Uno de los siguientes:

Valor	Significado
FileFsAttributeInformation	Devuelve una estructura de FILE_FS_ATTRIBUTE_INFORMATION que contiene información de atributo sobre el sistema de archivos responsable del volumen.
FileFsControlInformation	Devuelve una estructura de FILE_FS_CONTROL_INFORMATION que contiene información de control del sistema de archivos sobre el volumen.
FileFsDeviceInformation	Devuelve una estructura de FILE_FS_DEVICE_INFORMATION que contiene información del dispositivo para el volumen.
FileFsDriverPathInformation	Devuelve una estructura de FILE_FS_DRIVER_PATH_INFORMATION que contiene información sobre si un controlador especificado está en la ruta de acceso de E/S del volumen. El autor de la llamada debe almacenar el nombre del controlador en la estructura de FILE_FS_DRIVER_PATH_INFORMATION antes de llamar a FltQueryVolumeInformationFile.
FileFsFullSizeInformation	Devuelve una estructura FILE_FS_FULL_SIZE_INFORMATION que contiene información sobre la cantidad total de espacio disponible en el volumen.
FileFsObjectIdInformation	Devuelve una estructura de FILE_FS_OBJECTID_INFORMATION que contiene información del identificador de objeto específico del sistema de archivos para el volumen. Tenga en cuenta que no es el mismo que el nombre de volumen único (basado en GUID) asignado por el sistema operativo.
FileFsSizeInformation	Devuelve una estructura de FILE_FS_SIZE_INFORMATION que contiene información sobre la cantidad de espacio en el volumen que está disponible para el usuario asociado al subproceso que realiza la llamada.
FileFsVolumeInformation	Devuelve un FILE_FS_VOLUME_INFORMATION que contiene información sobre el volumen, como la etiqueta de volumen, el número de serie y el tiempo de creación.
FileFsSectorSizeInformation	Devuelve una estructura FILE_FS_SECTOR_SIZE_INFORMATION que contiene información sobre los tamaños de sector físico y lógico de un volumen.

[out, optional] LengthReturned

Puntero a una variable asignada por el autor de la llamada que recibe el tamaño, en bytes, de la información devuelta en el búfer FsInformation . Este parámetro es opcional y puede ser NULL.

Valor devuelto

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

Código devuelto	Descripción
STATUS_VOLUME_DISMOUNTED	El volumen no está montado actualmente. Se trata de un código de error.

Comentarios

FltQueryVolumeInformationFile recupera información de volumen de un archivo, directorio, dispositivo de almacenamiento o volumen determinado.

Si FileObject representa un dispositivo directo abierto, solo se puede especificar FileFsDeviceInformation como valor de FsInformationClass.

FltQueryVolumeInformationFile devuelve cero en cualquier miembro de una estructura FILE_FS_XXX_INFORMATION que no es compatible con un sistema de archivos determinado.