EVT_WDF_IO_QUEUE_IO_READ fungsi panggilan balik (wdfio.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi panggilan balik peristiwa EvtIoRead driver memproses permintaan baca tertentu.

Sintaks

EVT_WDF_IO_QUEUE_IO_READ EvtWdfIoQueueIoRead;

void EvtWdfIoQueueIoRead(
  [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 dibaca.

Nilai kembali

Tidak ada

Keterangan

Driver mendaftarkan fungsi panggilan balik EvtIoRead saat memanggil WdfIoQueueCreate. Untuk informasi selengkapnya tentang memanggil WdfIoQueueCreate, lihat Membuat Antrean I/O.

Jika driver telah mendaftarkan fungsi panggilan balik EvtIoRead untuk antrean I/O perangkat, fungsi panggilan balik menerima setiap permintaan baca dari antrean. Untuk informasi selengkapnya, lihat Penangan Permintaan.

Fungsi panggilan balik EvtIoRead harus memproses setiap permintaan I/O yang diterima dengan cara tertentu. Untuk informasi selengkapnya, lihat Memproses Permintaan I/O.

Permintaan baca memerlukan buffer output, yang menerima data yang disediakan driver. Untuk informasi tentang bagaimana driver dapat mengakses buffer permintaan baca, 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 EvtIoRead driver tidak boleh memanggil metode objek antrean berikut:

WdfIoQueueDrainSynchronously
WdfIoQueuePurgeSynchronously
WdfIoQueueStopSynchronously

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)

Lihat juga

EvtIoDefault

EvtIoWrite

WDF_OBJECT_ATTRIBUTES

WdfIoQueueBuat