共用方式為


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)

另請參閱

IoSetCancelRoutine