IQueueCallbackWrite::Metode OnWrite (wudfddi.h)
[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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | wudfddi.h (termasuk Wudfddi.h) |