IWDFIoRequest2：：IsCanceled 方法 (wudfddi.h)

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

IsCanceled 方法确定 I/O 管理器是否已尝试取消 I/O 请求。

语法

BOOL IsCanceled();

返回值

如果 I/O 管理器尝试取消 I/O 请求，则 IsCanceled 返回 TRUE。 此方法出于以下任一原因返回 FALSE ：

• I/O 管理器未尝试取消请求。
• 调用驱动程序不拥有请求。
• 调用驱动程序已调用 IWDFIoRequest：：MarkCancelable 方法。

注解

如果驱动程序尚未调用 IWDFIoRequest：：MarkCancelable 来注册 IRequestCallbackCancel：：OnCancel 回调函数，但如果希望驱动程序确定 I/O 管理器是否已尝试取消 I/O 请求，则驱动程序可以调用 IsCanceled。

仅当驱动程序拥有 I/O 请求时，驱动程序才能为请求调用 IsCanceled 。 如果驱动程序已调用 IWDFIoRequest：：MarkCancelable，则必须在调用 IsCanceled 之前调用 IWDFIoRequest：：UnmarkCancelable。

如果 IsCanceled 返回 TRUE，则驱动程序应通过调用 IWDFIoRequest：：Complete 来取消请求，并将 CompletionStatus 参数设置为 HRESULT_FROM_WIN32 (ERROR_OPERATION_ABORTED) 。

有关 IsCanceled 的详细信息，请参阅 取消 I/O 请求。

示例

在以下代码示例中，如果 IsCanceled 返回 TRUE，则驱动程序通过调用 IWDFIoRequest：：Complete 完成 I/O 请求，完成状态为HRESULT_FROM_WIN32 (ERROR_OPERATION_ABORTED) 。

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

要求

要求	值
结束支持	在 UMDF 2.0 及更高版本中不可用。
目标平台	桌面
最低 UMDF 版本	1.9
标头	wudfddi.h (包括 Wudfddi.h)
DLL	WUDFx.dll

另请参阅

IRequestCallbackCancel：：OnCancel

IWDFIoRequest2

IWDFIoRequest：：MarkCancelable

IWDFIoRequest：：UnmarkCancelable