Metode IWDFIoRequest2::IsCanceled (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 IsCanceled menentukan apakah manajer I/O telah mencoba membatalkan permintaan I/O.

Sintaks

BOOL IsCanceled();

Mengembalikan nilai

IsCanceled mengembalikan TRUE jika manajer I/O telah mencoba membatalkan permintaan I/O. Metode ini mengembalikan FALSE karena salah satu alasan berikut:

• Manajer I/O belum mencoba membatalkan permintaan.
• Driver panggilan tidak memiliki permintaan.
• Driver panggilan telah memanggil metode IWDFIoRequest::MarkCancelable .

Keterangan

Jika driver Anda belum memanggil IWDFIoRequest::MarkCancelable untuk mendaftarkan fungsi panggilan balik IRequestCallbackCancel::OnCancel , tetapi jika Anda ingin driver Anda menentukan apakah manajer I/O telah mencoba membatalkan permintaan I/O, driver dapat memanggil IsCanceled.

Driver dapat memanggil IsCanceled untuk permintaan hanya jika driver memiliki permintaan I/O. Jika driver telah memanggil IWDFIoRequest::MarkCancelable, driver harus memanggil IWDFIoRequest::UnmarkCancelable sebelum memanggil IsCanceled.

Jika IsCanceled mengembalikan TRUE, driver Anda harus membatalkan permintaan dengan memanggil IWDFIoRequest::Complete dengan parameter CompletionStatus diatur ke HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

Untuk informasi selengkapnya tentang IsCanceled, lihat Membatalkan Permintaan I/O.

Contoh

Dalam contoh kode berikut, jika IsCanceled mengembalikan TRUE, driver menyelesaikan permintaan I/O dengan memanggil IWDFIoRequest::Complete dengan status penyelesaian HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).

if (fxRequest2->IsCanceled())
{
    fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...

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)
DLL	WUDFx.dll

Lihat juga

IRequestCallbackCancel::OnCancel

IWDFIoRequest2

IWDFIoRequest::MarkCancelable

IWDFIoRequest::UnmarkCancelable