IQueueCallbackWrite::Metode OnWrite (wudfddi.h)

Artikel
02/27/2024

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode OnWrite dipanggil untuk menangani permintaan tulis saat aplikasi menulis informasi ke perangkat melalui fungsi Microsoft Win32 WriteFile atau WriteFileEx .

Sintaks

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

Parameter

[in] pWdfQueue

Penunjuk ke antarmuka IWDFIoQueue untuk objek antrean I/O tempat permintaan datang.

[in] pWdfRequest

Penunjuk ke antarmuka IWDFIoRequest yang mewakili objek permintaan kerangka kerja.

[in] NumOfBytesToWrite

Ukuran, dalam byte, dari buffer tulis untuk permintaan tersebut.

Nilai kembali

Tidak ada

Keterangan

Driver mendaftarkan antarmuka IQueueCallbackWrite saat driver memanggil metode IWDFDevice::CreateIoQueue untuk membuat antrean I/O atau untuk mengonfigurasi antrean I/O default.

Driver dapat menerapkan satu metode OnWrite untuk semua antrean I/O atau metode OnWrite terpisah untuk setiap antrean I/O.

Metode OnWrite menerima setiap jenis permintaan tulis dari antrean. (Jenis permintaan tulis diidentifikasi oleh nilai WdfRequestWrite dari jenis enumerasi WDF_REQUEST_TYPE untuk permintaan tersebut.) Metode OnWrite harus memproses setiap permintaan tulis yang diterima. Untuk informasi selengkapnya tentang cara driver UMDF memproses permintaan I/O, lihat Memproses Permintaan I/O.

Driver dapat memanggil metode IWDFIoRequest::GetWriteParameters dan IWDFIoRequest::GetInputMemory untuk mengambil informasi tentang permintaan dan buffer tulis.