IRequestCallbackCancel::Metode OnCancel (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 OnCancel dipanggil ketika aplikasi membatalkan operasi I/O melalui fungsi Microsoft Win32 CancelIo, CancelIoEx, atau CancelSynchronousIo .

Sintaks

void OnCancel(
  [in] IWDFIoRequest *pWdfRequest
);

Parameter

[in] pWdfRequest

Penunjuk ke antarmuka IWDFIoRequest yang mewakili objek permintaan kerangka kerja untuk dibatalkan.

Nilai kembali

Tidak ada

Keterangan

Kerangka kerja memanggil metode OnCancel untuk membatalkan permintaan I/O yang diidentifikasi parameter pWdfRequest . Driver harus terlebih dahulu menentukan apakah dapat membatalkan permintaan I/O. Jika permintaan dapat dibatalkan, driver harus membatalkannya. Untuk informasi selengkapnya tentang cara membatalkan permintaan, lihat Membatalkan Permintaan I/O.

Jika driver membatalkan permintaan, driver juga harus menyelesaikan permintaan dengan memanggil metode IWDFIoRequest::Complete dengan parameter CompletionStatus yang diatur ke HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

Kerangka kerja tidak memanggil OnCancel untuk membatalkan permintaan kecuali driver yang sebelumnya disebut metode IWDFIoRequest::MarkCancelable untuk mengaktifkan pembatalan permintaan dan mendaftarkan antarmuka IRequestCallbackCancel .

User-Mode Driver Framework (UMDF) hanya memungkinkan satu metode OnCancel per antrean. Oleh karena itu, ketika driver memanggil IWDFIoRequest::MarkCancelable untuk permintaan yang terkait dengan antrean tertentu untuk memungkinkan kerangka kerja membatalkan permintaan tersebut, driver harus meneruskan pointer ke antarmuka IRequestCallbackCancel untuk objek request-callback yang sama. Kemudian, untuk membatalkan setiap permintaan, kerangka kerja meneruskan penunjuk ke antarmuka IWDFIoRequest untuk permintaan dalam panggilan ke metode OnCancel objek request-callback ini.