共用方式為


WdfRequestIsCanceled 函式 (wdfrequest.h)

[適用於 KMDF 和 UMDF]

WdfRequestIsCanceled 方法會判斷 I/O 管理員是否嘗試取消指定的 I/O 要求。

語法

BOOLEAN WdfRequestIsCanceled(
  [in] WDFREQUEST Request
);

參數

[in] Request

架構要求物件的句柄。

傳回值

如果 I/O 管理員嘗試取消指定的 I/O 要求,WdfRequestIsCanceled 會傳回 TRUE。 即使呼叫驅動程式沒有擁有要求,這個方法仍可能會傳回 TRUE 。 如果驅動程式沒有擁有要求,它不應該呼叫 WdfRequestIsCanceled。 請參閱中的其他資訊。

WdfRequestIsCanceled 會 基於下列其中一個原因傳回 FALSE

如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。

備註

如果您的驅動程式尚未呼叫 WdfRequestMarkCancelableWdfRequestMarkCancelableEx 來註冊 EvtRequestCancel 回呼函式,但如果您想要讓驅動程式判斷 I/O 管理員是否已嘗試取消 I/O 要求,則驅動程式可以呼叫 WdfRequestIsCanceled

如果驅動程式已呼叫 WdfRequestMarkCancelableWdfRequestMarkCancelableEx,它必須先呼叫 WdfRequestUnmarkCancelable ,再呼叫 WdfRequestIsCanceled

只有在驅動程式擁有 I/O 要求時,驅動程式才能呼叫要求 WdfRequestIsCanceled

如果 WdfRequestIsCanceled 傳回 TRUE,您的驅動程式應該藉由呼叫具有 status 參數的 WdfRequestComplete 來取消要求STATUS_CANCELLED。 如果驅動程式嘗試完成它不擁有的要求,驅動程式可能會導致系統當機。

如需 WdfRequestIsCanceled 的詳細資訊,請參閱 取消 I/O 要求

範例

如果 WdfRequestIsCanceled 傳回 TRUE,下列程式代碼範例會呼叫 WdfRequestComplete

if (WdfRequestIsCanceled(request)) {
    WdfRequestComplete(
                       request,
                       STATUS_CANCELLED
                       );
}

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfrequest.h (包含 Wdf.h)
程式庫 Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate (kmdf) KmdfIrql (kmdf) KmdfIrql2 (kmdf) , KmdfIrqlExplicit (kmdf) , ReqIsCancOnCancReq (kmdf)

另請參閱

EvtRequestCancel

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx

WdfRequestUnmarkCancelable