Funzione FltQueryVolumeInformation (fltkernel.h)

Articolo
02/29/2024

La routine FltQueryVolumeInformation recupera informazioni sul volume a cui è associata 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 di istanza opaco per un'istanza del driver minifilter 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 FsInformation punta. Il chiamante deve impostare questo parametro in base all'oggetto FsInformationClass specificato. Ad esempio, se il valore di FsInformationClass è FileFsControlInformation, la lunghezza 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 sul file system responsabile del volume.
FileFsControlInformation	Restituisce una struttura FILE_FS_CONTROL_INFORMATION contenente informazioni sul controllo file system sul volume.
FileFsDeviceInformation	Restituire una struttura FILE_FS_DEVICE_INFORMATION contenente informazioni sul dispositivo per il volume.
FileFsDriverPathInformation	Restituisce una struttura FILE_FS_DRIVER_PATH_INFORMATION contenente 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 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 questo non corrisponde al nome del volume univoco (basato su GUID) assegnato dal sistema operativo. Nota Questo valore non è valido per i volumi 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 il tempo di creazione.
FileFsSectorSizeInformation	Restituisce una struttura FILE_FS_SECTOR_SIZE_INFORMATION che contiene informazioni sulle dimensioni del settore fisico e logico di un volume.

Valore restituito

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

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	FltQueryVolumeInformation ha 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	L'istanza è collegata 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.

Commenti

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

Requisiti

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