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