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. STATUS_CANCELLEDの状態値を指定して、 WdfRequestComplete を呼び出します。
このコールバック関数の詳細については、「 I/O 要求の取り消し」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfrequest.h (Wdf.h を含む)
IRQL <=DISPATCH_LEVEL

こちらもご覧ください

WdfRequestComplete

WdfRequestMarkCancelable

WdfRequestMarkCancelableEx