Función FltQueryVolumeInformation (fltkernel.h)

Artículo
08/07/2023

La rutina FltQueryVolumeInformation recupera información sobre el volumen al que está asociada la instancia especificada.

Sintaxis

NTSTATUS FLTAPI FltQueryVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parámetros

[in] Instance

Puntero de instancia opaco para una instancia de controlador de minifiltro que está asociada al volumen.

[out] Iosb

Puntero a la estructura de IO_STATUS_BLOCK asignada por el autor de la llamada que recibe el estado de finalización final e información sobre la operación de consulta. Para llamadas correctas que devuelven datos, el número de bytes escritos en el búfer FsInformation se devuelve en el miembro Information de la estructura.

[out] FsInformation

Puntero a un búfer asignado por el autor de la llamada que recibe la información deseada sobre el volumen. La estructura de la información devuelta en el búfer se define mediante el parámetro FsInformationClass .

[in] Length

Tamaño en bytes del búfer al que apunta FsInformation . El autor de la llamada debe establecer este parámetro según el FsInformationClass especificado. Por ejemplo, si el valor de FsInformationClass es FileFsControlInformation, Length debe ser al menos sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Tipo de información solicitada. Uno de los valores 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 llamador debe almacenar el nombre del controlador en la estructura FILE_FS_DRIVER_PATH_INFORMATION antes de llamar a FltQueryVolumeInformation.
FileFsFullSizeInformation	Devuelve una estructura de 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. Nota Este valor no es válido para los volúmenes de instantáneas.
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 del 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.

Valor devuelto

La rutina FltQueryVolumeInformation devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	FltQueryVolumeInformation encontró un error de asignación de grupo. Se trata de un código de error.
STATUS_INVALID_INFO_CLASS	Se especificó un valor no válido para FsInformationClass. Se trata de un código de error.
STATUS_INVALID_PARAMETER	La instancia está conectada a un volumen de red. FltQueryVolumeInformation no se puede usar para consultar información de volumen de red. Se trata de un código de error.

Comentarios

Los campos de la estructura FILE_XXX_INFORMATION que no son compatibles con el sistema de archivos subyacente se establecen en cero.

Para cambiar información sobre un volumen, llame a FltSetVolumeInformation.

Para obtener información de propiedad de volumen para el volumen especificado, llame a FltGetVolumeProperties.

Para obtener el nombre del volumen de un volumen determinado, llame a FltGetVolumeName.

Para obtener el nombre del GUID de volumen de un volumen determinado, llame a FltGetVolumeGuidName.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible y compatible con el paquete acumulativo de actualizaciones 1 de Microsoft Windows 2000 para SP4, Windows XP con Service Pack 2 (SP2), Windows Server 2003 SP1 y sistemas operativos Windows posteriores. No disponible o compatible con Windows 2000 SP4 y sistemas operativos Windows anteriores.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya FltKernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL