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 コールバック関数を呼び出すときに、ドライバーが要求を取り消すことができる場合は、次の操作を行う必要があります。
- 作成したサブ要求と共に、要求の処理を完了または停止します。
- STATUS_CANCELLEDの状態値を指定して、 WdfRequestComplete を呼び出します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| 最小 KMDF バージョン | 1.0 |
| 最小 UMDF バージョン | 2.0 |
| Header | wdfrequest.h (Wdf.h を含む) |
| IRQL | <=DISPATCH_LEVEL |