Fungsi ZwQueryVolumeInformationFile (ntifs.h)

Artikel
08/07/2023

Rutinitas ZwQueryVolumeInformationFile mengambil informasi tentang volume yang terkait dengan file, direktori, perangkat penyimpanan, atau volume tertentu.

Sintaks

NTSYSAPI NTSTATUS ZwQueryVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Parameter

[in] FileHandle

Handel ke objek file yang dikembalikan oleh ZwCreateFile atau ZwOpenFile untuk file terbuka, direktori, perangkat penyimpanan, atau volume yang informasi volumenya diminta.

[out] IoStatusBlock

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

[out] FsInformation

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

[in] Length

Ukuran dalam byte buffer yang diacu oleh FsInformation. Pemanggil harus mengatur parameter ini sesuai dengan FsInformationClass yang diberikan.

[in] FsInformationClass

Jenis informasi yang akan dikembalikan tentang volume. Atur anggota ini ke salah satu nilai enumerasi FS_INFORMATION_CLASS 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 tertentu berada di jalur I/O untuk volume. Pemanggil harus menyimpan nama driver ke dalam struktur FILE_FS_DRIVER_PATH_INFORMATION sebelum memanggil ZwQueryVolumeInformationFile.
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.

Mengembalikan nilai

ZwQueryVolumeInformationFile mengembalikan STATUS_SUCCESS atau status kesalahan yang sesuai.

Keterangan

ZwQueryVolumeInformationFile mengambil informasi tentang volume yang terkait dengan file, direktori, perangkat penyimpanan, atau volume tertentu.

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

ZwQueryVolumeInformationFile mengembalikan nol dalam setiap anggota struktur FILE_XXX_INFORMATION yang tidak didukung oleh sistem file.

Untuk informasi tentang rutinitas kueri informasi file lainnya, lihat Objek File.

Minifilter harus menggunakan FltQueryVolumeInformationFile alih-alih ZwQueryVolumeInformationFile.

Pemanggil ZwQueryVolumeInformationFile harus berjalan di IRQL = PASSIVE_LEVEL dan dengan APC kernel khusus diaktifkan.

Catatan

Jika panggilan ke fungsi ZwQueryVolumeInformationFile terjadi dalam mode pengguna, Anda harus menggunakan nama "NtQueryVolumeInformationFile" alih-alih "ZwQueryVolumeInformationFile".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinitas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menafsirkan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h, Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (lihat bagian Keterangan)
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)