ioCancelIrp 函式 (wdm.h)
IoCancelIrp 例程會在指定的 IRP 中設定取消位，並在有 IRP 時呼叫取消例程。
語法
BOOLEAN IoCancelIrp(
[in] PIRP Irp
);
參數
[in] Irp
要取消之 IRP 的指標。
傳回值
如果 IRP 有取消例程且呼叫此例程，IoCancelIrp 會傳回 TRUE。 否則會傳回 FALSE。 不論是哪一種情況，IRP 的取消位都設定為 TRUE。 如需詳細資訊，請參閱＜備註＞。
備註
如果 IRP 有取消例程， IoCancelIrp 會設定取消位並呼叫取消例程。
如果 Irp-CancelRoutine> 為 NULL，因此 IRP 無法取消，IoCancelIrp 會設定 IRP 的取消位並傳回 FALSE。 當 IRP 變成可取消時，應該在稍後取消。
如果沒有擁有 IRP 的驅動程式會呼叫 IoCancelIrp，則結果無法預測。 即使已設定 IRP 取消位，IRP 仍可能會以成功的狀態完成。
中繼驅動程式不應該任意呼叫 IoCancelIrp ，除非該驅動程式建立了傳入呼叫的 IRP。 否則，中繼驅動程式可能會取消一個 IRP，讓某些較高層級的驅動程式自行追蹤。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) |