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 要求。

Syntax

BOOL CancelSentRequest();

傳回值

CancelSentRequest 會傳回 BOOL 值，指出取消要求是否已成功傳遞至要求的擁有者。 TRUE 表示已成功傳遞要求。 FALSE 表示要求未成功傳遞。

備註

驅動程式可以呼叫 CancelSentRequest ，藉由呼叫 IWDFIoRequest：：Send 方法，嘗試取消先前傳送至 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