Fungsi IoCancelIrp (wdm.h)
Rutinitas IoCancelIrp menetapkan bit pembatalan dalam IRP tertentu dan memanggil rutinitas pembatalan untuk IRP jika ada.
Sintaks
BOOLEAN IoCancelIrp(
[in] PIRP Irp
);
Parameter
[in] Irp
Pointer ke IRP yang akan dibatalkan.
Mengembalikan nilai
IoCancelIrp mengembalikan TRUE jika IRP memiliki rutinitas pembatalan dan rutinitas ini dipanggil. Jika tidak, ia mengembalikan FALSE. Dalam kedua kasus, bit pembatalan IRP diatur ke TRUE. Untuk informasi selengkapnya, lihat Keterangan.
Keterangan
Jika IRP memiliki rutinitas pembatalan, IoCancelIrp mengatur bit pembatalan dan memanggil rutinitas pembatalan.
Jika Irp-CancelRoutine>adalah NULL, dan oleh karena itu IRP tidak dapat dibatalkan, IoCancelIrp menetapkan bit pembatalan IRP dan mengembalikan FALSE. IRP harus dibatalkan di lain waktu ketika menjadi dapat dibatalkan.
Jika driver yang tidak memiliki IRP memanggil IoCancelIrp, hasilnya tidak dapat diprediksi. IRP mungkin diselesaikan dengan status berhasil meskipun bit pembatalannya telah ditetapkan.
Driver perantara tidak boleh secara sewenang-wenang memanggil IoCancelIrp kecuali driver tersebut membuat IRP diteruskan dalam panggilan. Jika tidak, driver perantara mungkin membatalkan IRP yang dilacak oleh beberapa driver tingkat yang lebih tinggi untuk tujuannya sendiri.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Aturan kepatuhan DDI | HwStorPortProhibitedDDIs(storport) |