Fungsi KsQueryInformationFile (ks.h)
Fungsi KsQueryInformationFile melakukan kueri informasi terhadap objek file yang ditentukan. Fungsi ini mencoba menggunakan FastIoDispatch jika memungkinkan, atau menghasilkan permintaan informasi terhadap objek perangkat.
Sintaks
KSDDKAPI NTSTATUS KsQueryInformationFile(
[in] PFILE_OBJECT FileObject,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass
);
Parameter
[in] FileObject
Menentukan objek file untuk mengkueri informasi standar.
[out] FileInformation
Menunjukkan tempat untuk meletakkan informasi file. Ini diasumsikan sebagai alamat yang valid atau diperiksa.
[in] Length
Menentukan panjang buffer FileInformation yang benar.
[in] FileInformationClass
Menentukan kelas informasi yang diminta.
Nilai kembali
Fungsi KsQueryInformationFile mengembalikan STATUS_SUCCESS jika berhasil, atau jika tidak berhasil, fungsi tersebut mengembalikan kesalahan kueri.
Keterangan
Fungsi KsQueryInformationFile hanya boleh digunakan dalam kasus di mana kueri akan menghasilkan permintaan aktual ke driver yang mendasar. Misalnya, FilePositionInformation tidak akan menghasilkan permintaan seperti itu dan tidak boleh digunakan. Ini mengasumsikan pemanggil sedang menserialisasikan akses ke file untuk operasi terhadap objek file FO_SYNCHRONOUS_IO.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | ks.h (termasuk Ks.h) |
Pustaka | Ks.lib |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk