EVT_WDF_IO_QUEUE_IO_WRITE fungsi panggilan balik (wdfio.h)
[Berlaku untuk KMDF dan UMDF]
Fungsi panggilan balik peristiwa EvtIoWrite driver memproses permintaan tulis tertentu.
Sintaks
EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;
void EvtWdfIoQueueIoWrite(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
Parameter
[in] Queue
Handel ke objek antrean kerangka kerja yang terkait dengan permintaan I/O.
[in] Request
Handel ke objek permintaan kerangka kerja.
[in] Length
Jumlah byte yang akan ditulis.
Nilai kembali
Tidak ada
Keterangan
Driver mendaftarkan fungsi panggilan balik EvtIoWrite saat memanggil WdfIoQueueCreate. Untuk informasi selengkapnya tentang memanggil WdfIoQueueCreate, lihat Membuat Antrean I/O.
Jika driver telah mendaftarkan fungsi panggilan balik EvtIoWrite untuk antrean I/O perangkat, fungsi panggilan balik menerima setiap permintaan tulis dari antrean. Untuk informasi selengkapnya, lihat Penangan Permintaan.
Fungsi panggilan balik EvtIoWrite harus memproses setiap permintaan I/O yang diterima dengan cara tertentu. Untuk informasi selengkapnya, lihat Memproses Permintaan I/O.
Permintaan tulis memerlukan buffer input, yang berisi data yang diterima driver. Untuk informasi tentang bagaimana driver dapat mengakses buffer permintaan tulis, lihat Mengakses Buffer Data di driver Framework-Based.
Fungsi panggilan balik ini dapat dipanggil di IRQL <= DISPATCH_LEVEL, kecuali anggota ExecutionLevel dari perangkat atau struktur WDF_OBJECT_ATTRIBUTES driver diatur ke WdfExecutionLevelPassive.
Jika IRQL PASSIVE_LEVEL, kerangka kerja memanggil fungsi panggilan balik dalam wilayah penting.
Untuk informasi selengkapnya tentang tingkat IRQL untuk penangan permintaan, lihat Menggunakan Sinkronisasi Otomatis.
Fungsi panggilan balik EvtIoWrite driver tidak boleh memanggil metode objek antrean berikut:
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Versi UMDF minimum | 2.0 |
Header | wdfio.h (termasuk Wdf.h) |
IRQL | <= DISPATCH_LEVEL (lihat bagian Keterangan) |