Metode IQueueCallbackIoCanceledOnQueue::OnIoCanceledOnQueue (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.]
Fungsi panggilan balik peristiwa OnIoCanceledOnQueue driver memberi tahu driver bahwa permintaan I/O dibatalkan saat berada dalam antrean I/O.
Sintaks
void OnIoCanceledOnQueue(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest
);
Parameter
[in] pWdfQueue
Penunjuk ke antarmuka IWDFIoQueue untuk antrean I/O tempat permintaan I/O berada saat dibatalkan.
[in] pWdfRequest
Penunjuk ke antarmuka IWDFIoRequest untuk permintaan I/O.
Nilai kembali
Tidak ada
Keterangan
Driver mendaftarkan antarmuka IQueueCallbackIoCanceledOnQueue antrean I/O dan fungsi panggilan balik OnIoCanceledOnQueue saat driver memanggil IWDFDevice::CreateIoQueue. Untuk informasi selengkapnya tentang cara mendaftarkan antarmuka, lihat IQueueCallbackIoCanceledOnQueue.
Jika driver mendaftarkan fungsi panggilan balik OnIoCanceledOnQueue untuk antrean I/O, kerangka kerja memanggil fungsi panggilan balik jika handler permintaan menerima permintaan I/O dari antrean I/O, driver memanggil IWDFIoRequest::ForwardToIoQueue atau IWDFIoRequest2::Requeue untuk mengantre ulang permintaan ke antrean I/O tempat fungsi panggilan balik OnIoCanceledOnQueue terdaftar, dan operasi I/O terkait kemudian dibatalkan.
Setelah kerangka kerja memanggil fungsi panggilan balik OnIoCanceledOnQueue , driver memiliki objek permintaan dan, oleh karena itu, harus membatalkan permintaan.
Kerangka kerja tidak memanggil fungsi panggilan balik OnIoCanceledOnQueue driver untuk permintaan I/O yang belum pernah dikirimkan kerangka kerja ke driver.
Kerangka kerja memanggil fungsi panggilan balik OnIoCanceledOnQueue segera setelah menentukan bahwa permintaan I/O telah dibatalkan, terlepas dari metode pengiriman yang telah ditetapkan driver untuk antrean I/O. Oleh karena itu, kerangka kerja dapat memanggil fungsi panggilan balik OnIoCanceledOnQueue untuk permintaan dalam antrean yang menggunakan pengiriman berurutan, bahkan jika driver saat ini memiliki permintaan lain dari antrean.
Untuk informasi selengkapnya tentang fungsi panggilan balik OnIoCanceledOnQueue , lihat Membatalkan Permintaan I/O.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1.9 |
| Header | wudfddi.h (termasuk Wudfddi.h) |