WdfRequestSetCompletionRoutine 関数 (wdfrequest.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfRequestSetCompletionRoutine メソッドは、指定されたフレームワーク要求オブジェクトの完了ルーチンを登録または登録解除します。

構文

void WdfRequestSetCompletionRoutine(
  [in]           WDFREQUEST                         Request,
  [in, optional] PFN_WDF_REQUEST_COMPLETION_ROUTINE CompletionRoutine,
  [in, optional] __drv_aliasesMem WDFCONTEXT        CompletionContext
);

パラメーター

[in] Request

フレームワーク要求オブジェクトへのハンドル。

[in, optional] CompletionRoutine

ドライバーが完了ルーチンを登録している場合、またはドライバーの NULL が以前に登録された完了ルーチンを登録解除している場合は、CompletionRoutine コールバック関数へのポインター。

[in, optional] CompletionContext

フレームワークが CompletionRoutine コールバック関数に渡すドライバー定義のコンテキスト情報への型指定されていないポインター。 このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

なし

解説

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

ドライバーが I/O 要求を転送するが、下位レベルのドライバーが要求を完了したときにドライバーに通知する場合、ドライバーは CompletionRoutine コールバック関数を提供し、 WdfRequestSetCompletionRoutine を呼び出して関数を登録できます。 フレームワークは、下位レベルのドライバーが I/O 要求を完了した後、コールバック関数を呼び出します。

WdfRequestSetCompletionRoutine の詳細については、「I/O 要求の完了」を参照してください。

例

WdfRequestSetCompletionRoutine を使用するコード例については、「WdfRequestSend」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfrequest.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)、 InvalidReqAccess(kmdf)、 InvalidReqAccessLocal(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 ReqCompletionRoutine(kmdf)

こちらもご覧ください

CompletionRoutine