Fungsi KsWriteFile (ks.h)

Fungsi KsWriteFile melakukan penulisan terhadap objek file yang ditentukan. Diasumsikan bahwa penelepon menserialisasikan akses ke file untuk operasi terhadap objek file FO_SYNCHRONOUS_IO. Fungsi ini mencoba menggunakan FastIoDispatch jika memungkinkan, atau menghasilkan permintaan tulis terhadap objek perangkat. Semua statistik yang relevan diperbarui.

Sintaksis

KSDDKAPI NTSTATUS KsWriteFile(
  [in]           PFILE_OBJECT     FileObject,
  [in, optional] PKEVENT          Event,
  [in, optional] PVOID            PortContext,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [in]           PVOID            Buffer,
  [in]           ULONG            Length,
  [in, optional] ULONG            Key,
  [in]           KPROCESSOR_MODE  RequestorMode
);

Parameter

[in] FileObject

Menentukan objek file untuk melakukan pembacaan terhadap.

[in, optional] Event

Secara opsional berisi peristiwa yang akan digunakan dalam tulis. Jika tidak ada peristiwa yang diteruskan, panggilan diasumsikan berada di objek file sinkron atau pemanggil sedang menunggu peristiwa objek file. Jika panggilan tidak berada pada objek file sinkron, panggilan dapat diselesaikan secara asinkron. Jika file telah dibuka untuk I/O sinkron, variabel ini harus NULL. Jika variabel ini digunakan, itu harus merupakan peristiwa yang dialokasikan oleh manajer objek.

[in, optional] PortContext

Secara opsional berisi informasi konteks untuk port penyelesaian.

[out] IoStatusBlock

Menunjukkan lokasi untuk mengembalikan informasi status. Ini selalu diasumsikan sebagai alamat yang valid, terlepas dari mode pemohon.

[in] Buffer

Menentukan buffer untuk menulis data. Jika buffer perlu diperiksa dan dikunci, handler pengecualian digunakan, bersama dengan RequesterMode.

[in] Length

Menentukan ukuran buffer yang diteruskan.

[in, optional] Key

Secara opsional berisi kunci, atau nol jika tidak ada.

[in] RequestorMode

Menunjukkan mode prosesor untuk ditempatkan di IRP baca jika perlu dibuat. Selain itu, ini digunakan jika buffer perlu diperiksa dan dikunci. Variabel ini juga menentukan apakah panggilan I/O cepat dapat dilakukan. Jika mode pemohon bukan KernelMode, tetapi mode sebelumnya adalah, maka I/O cepat tidak dapat digunakan.

Mengembalikan nilai

Fungsi KsWriteFile mengembalikan STATUS_SUCCESS jika berhasil, STATUS_PENDING jika tindakan tertunda, atau mengembalikan kesalahan baca jika tidak berhasil.

Persyaratan