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