EVT_WDF_REQUEST_CANCEL回呼函式 (wdfrequest.h)

  • 發行項

[適用於 KMDF 和 UMDF]

驅動程式的 EvtRequestCancel 事件回呼函式會處理在取消 I/O 要求時必須執行的作業。

語法

EVT_WDF_REQUEST_CANCEL EvtWdfRequestCancel;

void EvtWdfRequestCancel(
  [in] WDFREQUEST Request
)
{...}

參數

[in] Request

架構要求物件的句柄，表示正在取消的 I/O 要求。

傳回值

無

備註

若要註冊 EvtRequestCancel 回呼函式，驅動程式必須呼叫 WdfRequestMarkCancelable 或 WdfRequestMarkCancelableEx。

當架構呼叫驅動程式的 EvtRequestCancel 回呼函式時，如果驅動程式可以取消要求，則必須：

  1. 完成或停止處理要求，以及可能已建立的子查詢。
  2. 呼叫 WdfRequestComplete，並指定狀態值STATUS_CANCELLED。
如需此回呼函式的詳細資訊，請參閱 取消 I/O 要求。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfrequest.h (包含 Wdf.h)
IRQL <=DISPATCH_LEVEL

另請參閱

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx