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