Metode IQueueCallbackRead::OnRead (wudfddi.h)

Artikel
03/01/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 OnRead dipanggil untuk menangani permintaan baca saat aplikasi membaca informasi dari perangkat melalui fungsi ReadFile atau ReadFileEx Microsoft Win32.

Sintaks

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

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] NumOfBytesToRead

Ukuran, dalam byte, dari buffer baca untuk permintaan.

Nilai kembali

Tidak ada

Keterangan

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

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

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

Driver dapat memanggil metode IWDFIoRequest::GetReadParameters dan IWDFIoRequest::GetOutputMemory untuk mengambil informasi tentang permintaan dan buffer baca.