Funzione FltQueryVolumeInformationFile (fltkernel.h)

Articolo
08/07/2023

FltQueryVolumeInformationFile recupera le 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 istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] FileObject

Puntatore a oggetti file per un file aperto, directory, dispositivo di archiviazione o 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. I tipi validi sono:

Valore	Significato
FileFsAttributeInformation	Restituisce una struttura FILE_FS_ATTRIBUTE_INFORMATION che contiene informazioni sull'attributo sul file system responsabile del volume.
FileFsControlInformation	Restituisce una struttura FILE_FS_CONTROL_INFORMATION che contiene informazioni sul controllo 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 sul fatto che un driver specificato si trova 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 del volume univoco (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 del settore fisico e logico di un volume.

[out, optional] LengthReturned

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

Valore restituito

FltQueryVolumeInformationFile restituisceSTATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio quanto segue:

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

Commenti

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

Se 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.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	fltkernel.h (includere Fltkernel.h)
Libreria	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL