Condividi tramite


Funzione FltQueryVolumeInformationFile (fltkernel.h)

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

Vedi anche

FILE_FS_ATTRIBUTE_INFORMATION

FILE_FS_CONTROL_INFORMATION

FILE_FS_DEVICE_INFORMATION

FILE_FS_DRIVER_PATH_INFORMATION

FILE_FS_FULL_SIZE_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FILE_FS_SECTOR_SIZE_INFORMATION

FILE_FS_SIZE_INFORMATION

FILE_FS_VOLUME_INFORMATION

FltSetInformationFile