Funzione FltQueryVolumeInformation (fltkernel.h)

Articolo
02/06/2025

La routine FltQueryVolumeInformation recupera informazioni sul volume a cui è collegata l'istanza specificata.

Sintassi

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

Parametri

[in] Instance

Puntatore a un'istanza opaca per un'istanza del driver minifiltro collegata al volume.

[out] Iosb

Puntatore alla struttura IO_STATUS_BLOCK allocata dal chiamante che riceve lo stato di completamento finale e informazioni sull'operazione di query. Per le chiamate riuscite che restituiscono dati, il numero di byte scritti nel buffer FsInformation viene restituito nel membro Information della struttura.

[out] FsInformation

Puntatore a un buffer allocato dal chiamante che riceve le informazioni desiderate sul volume. La struttura delle informazioni restituite nel buffer è definita dal parametro FsInformationClass.

[in] Length

Dimensioni in byte del buffer a cui punta FsInformation. Il chiamante deve impostare questo parametro in base all'FsInformationClass. Ad esempio, se il valore di FsInformationClass è FileFsControlInformation, Length deve essere almeno sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Tipo di informazioni richieste. Uno dei valori seguenti.

Valore	Significato
FileFsAttributeInformation	Restituisce una struttura FILE_FS_ATTRIBUTE_INFORMATION contenente informazioni sull'attributo relative al file system responsabile del volume.
FileFsControlInformation	Restituisce una struttura FILE_FS_CONTROL_INFORMATION contenente informazioni sul controllo del file system sul volume.
FileFsDeviceInformation	Restituisce una struttura FILE_FS_DEVICE_INFORMATION contenente le informazioni sul dispositivo per il volume.
FileFsDriverPathInformation	Restituisce una struttura FILE_FS_DRIVER_PATH_INFORMATION contenente 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 FltQueryVolumeInformation.
FileFsFullSizeInformation	Restituisce una struttura FILE_FS_FULL_SIZE_INFORMATION contenente informazioni sulla quantità totale di spazio disponibile nel volume.
FileFsObjectIdInformation	Restituisce una struttura FILE_FS_OBJECTID_INFORMATION contenente informazioni sull'ID oggetto specifico del file system per il volume. Tenere presente che non corrisponde al nome univoco del volume (basato su GUID) assegnato dal sistema operativo. Nota Questo valore non è valido per i volumi di snapshot.
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 contenente 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.

Valore restituito

La routine FltQueryVolumeInformation restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	FltQueryVolumeInformation rilevato un errore di allocazione del pool. Si tratta di un codice di errore.
STATUS_INVALID_INFO_CLASS	È stato specificato un valore non valido per FsInformationClass. Si tratta di un codice di errore.
STATUS_INVALID_PARAMETER	Il dell'istanza di è collegato a un volume di rete. Non è possibile usare FltQueryVolumeInformation per eseguire query sulle informazioni sul volume di rete. Si tratta di un codice di errore.

Osservazioni

I campi nella struttura FILE_XXX_INFORMATION non supportati dal file system sottostante sono impostati su zero.

Per modificare le informazioni su un volume, chiamare FltSetVolumeInformation.

Per ottenere informazioni sulle proprietà del volume per il volume specificato, chiamare FltGetVolumeProperties.

Per ottenere il nome del volume per un determinato volume, chiamare FltGetVolumeName.

Per ottenere il nome GUID del volume per un determinato volume, chiamare FltGetVolumeGuidName.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile e supportato in Microsoft Windows 2000 Update Rollup 1 per SP4, Windows XP con Service Pack 2 (SP2), Windows Server 2003 SP1 e sistemi operativi Windows successivi. Non disponibile o supportato in Windows 2000 SP4 e nei sistemi operativi Windows precedenti.
piattaforma di destinazione	Universale
intestazione	fltkernel.h (include FltKernel.h)
libreria	FltMgr.lib
dll	Fltmgr.sys
IRQL	PASSIVE_LEVEL