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