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)