IWDFIoRequest：：CancelSentRequest 方法 (wudfddi.h)

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

CancelSentRequest 方法尝试取消驱动程序之前提交到 I/O 目标的 I/O 请求。

语法

BOOL CancelSentRequest();

返回值

CancelSentRequest 返回一个 BOOL 值，该值指示取消请求是否已成功传递给请求的所有者。 TRUE 表示请求已成功传递。 FALSE 表示请求未成功传递。

注解

驱动程序可以通过调用 IWDFIoRequest：：Send 方法，调用 CancelSentRequest 来尝试取消之前发送到 I/O 目标的 I/O 请求。

如果请求位于 I/O 目标的队列中，框架将取消该请求。 如果框架已将请求传递到 I/O 目标的驱动程序，并且该驱动程序以前调用 了 IWDFIoRequest：：MarkCancelable 以启用取消，则框架将调用该驱动程序的 IRequestCallbackCancel：：OnCancel 方法。 如果目标的驱动程序未调用 IWDFIoRequest：：MarkCancelable，则请求不会取消，除非请求随后变为可取消。

如果驱动程序以前为请求的完成例程注册了 IRequestCallbackRequestCompletion 接口，则框架会在取消请求后调用完成例程。

要求

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

另请参阅

IRequestCallbackCancel：：OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest：：MarkCancelable

IWDFIoRequest：：Send