Fungsi FltQueryVolumeInformation (fltkernel.h)

Artikel
02/26/2024

Rutinitas FltQueryVolumeInformation mengambil informasi tentang volume yang dilampirkan instans tertentu.

Sintaks

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

Parameter

[in] Instance

Penunjuk instans buram untuk instans driver minifilter yang melekat pada volume.

[out] Iosb

Penunjuk ke struktur IO_STATUS_BLOCK yang dialokasikan pemanggil yang menerima status penyelesaian akhir dan informasi tentang operasi kueri. Untuk panggilan yang berhasil yang mengembalikan data, jumlah byte yang ditulis ke buffer FsInformation dikembalikan di anggota Informasi struktur.

[out] FsInformation

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima informasi yang diinginkan tentang volume. Struktur informasi yang dikembalikan dalam buffer ditentukan oleh parameter FsInformationClass .

[in] Length

Ukuran dalam byte buffer yang ditolak FsInformation . Pemanggil harus mengatur parameter ini sesuai dengan FsInformationClass yang diberikan. Misalnya, jika nilai FsInformationClass adalah FileFsControlInformation, Panjang harus setidaknya sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Jenis informasi yang diminta. Salah satu nilai berikut.

Nilai	Makna
FileFsAttributeInformation	Mengembalikan struktur FILE_FS_ATTRIBUTE_INFORMATION yang berisi informasi atribut tentang sistem file yang bertanggung jawab atas volume.
FileFsControlInformation	Mengembalikan struktur FILE_FS_CONTROL_INFORMATION yang berisi informasi kontrol sistem file tentang volume.
FileFsDeviceInformation	Mengembalikan struktur FILE_FS_DEVICE_INFORMATION yang berisi informasi perangkat untuk volume.
FileFsDriverPathInformation	Mengembalikan struktur FILE_FS_DRIVER_PATH_INFORMATION yang berisi informasi tentang apakah driver tertentu berada di jalur I/O untuk volume. Pemanggil harus menyimpan nama driver ke dalam struktur FILE_FS_DRIVER_PATH_INFORMATION sebelum memanggil FltQueryVolumeInformation.
FileFsFullSizeInformation	Mengembalikan struktur FILE_FS_FULL_SIZE_INFORMATION yang berisi informasi tentang jumlah total ruang yang tersedia pada volume.
FileFsObjectIdInformation	Mengembalikan struktur FILE_FS_OBJECTID_INFORMATION yang berisi informasi ID objek khusus sistem file untuk volume. Ketahuilah bahwa ini tidak sama dengan nama volume unik (berbasis GUID) yang ditetapkan oleh sistem operasi. Catatan Nilai ini tidak valid untuk volume rekam jepret.
FileFsSizeInformation	Mengembalikan struktur FILE_FS_SIZE_INFORMATION yang berisi informasi tentang jumlah ruang pada volume yang tersedia untuk pengguna yang terkait dengan utas panggilan.
FileFsVolumeInformation	Mengembalikan FILE_FS_VOLUME_INFORMATION yang berisi informasi tentang volume seperti label volume, nomor seri, dan waktu pembuatan.
FileFsSectorSizeInformation	Mengembalikan struktur FILE_FS_SECTOR_SIZE_INFORMATION yang berisi informasi tentang ukuran sektor fisik dan logis volume.

Nilai kembali

Rutinitas FltQueryVolumeInformation mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_INSUFFICIENT_RESOURCES	FltQueryVolumeInformation mengalami kegagalan alokasi kumpulan. Ini adalah kode kesalahan.
STATUS_INVALID_INFO_CLASS	Nilai yang tidak valid ditentukan untuk FsInformationClass. Ini adalah kode kesalahan.
STATUS_INVALID_PARAMETER	Instans dilampirkan ke volume jaringan. FltQueryVolumeInformation tidak dapat digunakan untuk mengkueri informasi volume jaringan. Ini adalah kode kesalahan.

Keterangan

Bidang dalam struktur FILE_XXX_INFORMATION yang tidak didukung oleh sistem file yang mendasar diatur ke nol.

Untuk mengubah informasi tentang volume, panggil FltSetVolumeInformation.

Untuk mendapatkan informasi properti volume untuk volume yang diberikan, panggil FltGetVolumeProperties.

Untuk mendapatkan nama volume untuk volume tertentu, panggil FltGetVolumeName.

Untuk mendapatkan nama GUID volume untuk volume tertentu, panggil FltGetVolumeGuidName.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dan didukung di Microsoft Windows 2000 Update Rollup 1 untuk SP4, Windows XP dengan Paket Layanan 2 (SP2), Windows Server 2003 SP1 dan sistem operasi Windows yang lebih baru. Tidak tersedia atau didukung di Windows 2000 SP4 dan sistem operasi Windows yang lebih lama.
Target Platform	Universal
Header	fltkernel.h (termasuk FltKernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL