Funzione FltQueryVolumeInformationFile (fltkernel.h)

Articolo
02/06/2025

FltQueryVolumeInformationFile recupera informazioni sul volume per un determinato file, directory, dispositivo di archiviazione o volume.

Sintassi

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
);

Parametri

[in] Instance

Puntatore dell'istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] FileObject

Puntatore a oggetti file per un file aperto, una directory, un dispositivo di archiviazione o un volume. Questo parametro è obbligatorio e non può essere NULL.

[out] FsInformation

Puntatore a un buffer allocato dal chiamante che riceve informazioni sul file. Il parametro FsInformationClass specifica il tipo di informazioni. Questo parametro è obbligatorio e non può essere NULL.

[in] Length

Dimensioni, in byte, del buffer FsInformation.

[in] FsInformationClass

Tipo di informazioni sul volume da restituire. Uno dei seguenti:

Valore	Significato
FileFsAttributeInformation	Restituisce una struttura FILE_FS_ATTRIBUTE_INFORMATION che contiene informazioni sugli attributi sul file system responsabile del volume.
FileFsControlInformation	Restituisce una struttura FILE_FS_CONTROL_INFORMATION che contiene informazioni sul controllo del file system sul volume.
FileFsDeviceInformation	Restituisce una struttura FILE_FS_DEVICE_INFORMATION che contiene informazioni sul dispositivo per il volume.
FileFsDriverPathInformation	Restituisce una struttura FILE_FS_DRIVER_PATH_INFORMATION che contiene informazioni sull'eventuale presenza di un driver specificato nel percorso di I/O per il volume. Il chiamante deve archiviare il nome del driver nella struttura FILE_FS_DRIVER_PATH_INFORMATION prima di chiamare FltQueryVolumeInformationFile.
FileFsFullSizeInformation	Restituisce una struttura FILE_FS_FULL_SIZE_INFORMATION che contiene informazioni sulla quantità totale di spazio disponibile nel volume.
FileFsObjectIdInformation	Restituisce una struttura FILE_FS_OBJECTID_INFORMATION che contiene informazioni sull'ID oggetto specifico del file system per il volume. Si noti che non corrisponde al nome univoco del volume (basato su GUID) assegnato dal sistema operativo.
FileFsSizeInformation	Restituisce una struttura FILE_FS_SIZE_INFORMATION contenente informazioni sulla quantità di spazio nel volume disponibile per l'utente associato al thread chiamante.
FileFsVolumeInformation	Restituisce un FILE_FS_VOLUME_INFORMATION che contiene informazioni sul volume, ad esempio l'etichetta del volume, il numero di serie e l'ora di creazione.
FileFsSectorSizeInformation	Restituisce una struttura FILE_FS_SECTOR_SIZE_INFORMATION che contiene informazioni sulle dimensioni fisiche e logiche di un volume.

[out, optional] LengthReturned

Puntatore a una variabile allocata dal chiamante che riceve le dimensioni, in byte, delle informazioni restituite nel buffer FsInformation. Questo parametro è facoltativo e può essere NULL.

Valore restituito

FltQueryVolumeInformationFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio il seguente:

Codice restituito	Descrizione
STATUS_VOLUME_DISMOUNTED	Il volume non è attualmente montato. Si tratta di un codice di errore.

Osservazioni

FltQueryVolumeInformationFile recupera informazioni sul volume per un determinato file, directory, dispositivo di archiviazione o volume.

Se il FileObject rappresenta un dispositivo diretto aperto, è possibile specificare solo FileFsDeviceInformation come valore di FsInformationClass.

FltQueryVolumeInformationFile restituisce zero in qualsiasi membro di una struttura FILE_FS_XXX_INFORMATION non supportata da un file system specifico.