Fungsi KsSetInformationFile (ks.h)

Fungsi KsSetInformationFile melakukan set informasi terhadap objek file yang ditentukan. Fungsi ini mencoba menggunakan FastIoDispatch jika memungkinkan, atau menghasilkan informasi yang diatur terhadap objek perangkat.

Sintaks

KSDDKAPI NTSTATUS KsSetInformationFile(
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

Parameter

[in] FileObject

Menentukan objek file untuk mengatur informasi standar.

[in] FileInformation

Menunjukkan tempat untuk meletakkan informasi file. Informasi file diasumsikan sebagai alamat yang valid atau diperiksa.

[in] Length

Menentukan panjang buffer FileInformation yang benar.

[in] FileInformationClass

Menentukan kelas informasi yang sedang ditetapkan.

Nilai kembali

Fungsi KsSetInformationFile mengembalikan STATUS_SUCCESS jika berhasil, atau jika tidak berhasil, fungsi tersebut mengembalikan kesalahan yang ditetapkan.

Keterangan

Fungsi KsSetInformationFile harus digunakan hanya ketika set akan menghasilkan permintaan aktual ke driver yang mendasar, tidak termasuk operasi kompleks yang memerlukan parameter tambahan untuk dikirim ke driver seperti ganti nama, penghapusan, dan penyelesaian. 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