Fungsi FltQueryVolumeInformationFile (fltkernel.h)

Artikel
08/07/2023

FltQueryVolumeInformationFile mengambil informasi volume untuk file, direktori, perangkat penyimpanan, atau volume tertentu.

Sintaks

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
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk file terbuka, direktori, perangkat penyimpanan, atau volume. Parameter ini diperlukan dan tidak boleh NULL.

[out] FsInformation

Penunjuk ke buffer yang dialokasikan pemanggil yang menerima informasi tentang file. Parameter FsInformationClass menentukan jenis informasi. Parameter ini diperlukan dan tidak boleh NULL.

[in] Length

Ukuran, dalam byte, dari buffer FsInformation .

[in] FsInformationClass

Jenis informasi volume yang akan dikembalikan. Salah satu dari berikut ini:

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 yang ditentukan berada di jalur I/O untuk volume. Pemanggil harus menyimpan nama driver ke dalam struktur FILE_FS_DRIVER_PATH_INFORMATION sebelum memanggil FltQueryVolumeInformationFile.
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. Perhatikan bahwa ini tidak sama dengan nama volume unik (berbasis GUID) yang ditetapkan oleh sistem operasi.
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.

[out, optional] LengthReturned

Penunjuk ke variabel yang dialokasikan penelepon yang menerima ukuran, dalam byte, dari informasi yang dikembalikan dalam buffer FsInformation . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FltQueryVolumeInformationFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai seperti berikut ini:

Menampilkan kode	Deskripsi
STATUS_VOLUME_DISMOUNTED	Volume saat ini tidak dipasang. Ini adalah kode kesalahan.

Keterangan

FltQueryVolumeInformationFile mengambil informasi volume untuk file, direktori, perangkat penyimpanan, atau volume tertentu.

Jika FileObject mewakili perangkat langsung yang terbuka, hanya FileFsDeviceInformation yang dapat ditentukan sebagai nilai FsInformationClass.

FltQueryVolumeInformationFile mengembalikan nol dalam setiap anggota struktur FILE_FS_XXX_INFORMATION yang tidak didukung oleh sistem file tertentu.