EVT_WDF_REQUEST_IMPERSONATE コールバック関数 (wdfrequest.h)

[UMDF にのみ適用]

ドライバーの EvtRequestImpersonate イベント コールバック関数は、保護されたファイルを開くなど、要求された偽装レベルでタスクを実行します。

構文

EVT_WDF_REQUEST_IMPERSONATE EvtWdfRequestImpersonate;

void EvtWdfRequestImpersonate(
  [in]           WDFREQUEST Request,
  [in, optional] PVOID Context
)
{...}

パラメーター

[in] Request

偽装を必要とする I/O 要求を表すフレームワーク要求オブジェクトへのハンドル。

[in, optional] Context

WdfRequestImpersonate メソッドで以前に指定されたコンテキストへのポインター。 このパラメーターは省略可能であり、コンテキストが必要ない場合は NULL にすることができます。

戻り値

なし

解説

User-Mode Driver Framework (UMDF) では、ドライバーの EvtRequestImpersonate コールバック関数がフレームワークのオブジェクト メソッドを呼び出すことを許可していません。 これにより、ドライバーが他のドライバー コールバック関数や他のドライバーに偽装レベルを公開しないようにします。

EVT_WDF_REQUEST_IMPERSONATE関数型は、Wdfrequest.h ヘッダー ファイルで定義されます。 コード分析ツールを実行するときにエラーをより正確に識別するには、必ず注釈を _Use_decl_annotations_ 関数定義に追加してください。 注釈を _Use_decl_annotations_ 使用すると、ヘッダー ファイル内の EVT_WDF_REQUEST_IMPERSONATE 関数型に適用される注釈が確実に使用されます。

次の制限も適用されます。

• ドライバーが で WdfRequestImpersonateImpersonationLevel = SecurityIdentificationを呼び出すとき、コールバックは LoadLibrary を呼び出したり、アクセスチェックを必要とするアクションを実行したりできません。

• DLL の遅延読み込みにも同じ原則が適用されます。 ドライバーが識別レベルで偽装し、コールバックが GetUserNameW を呼び出す例を考えてみましょう。 この API は遅延によって別の DLL を読み込み、 GetUserNameExW を呼び出すので、最初の呼び出し はERROR_PROC_NOT_FOUND または ERROR_BAD_IMPERSONATION_LEVELで失敗する可能性があります。 このような場合、コールバックは代わりに GetUserNameExW を 直接呼び出す必要があります。

詳細については、「 UMDF ドライバーでのクライアント偽装の処理」を参照してください。

例

EvtRequestImpersonate コールバック関数を定義するには、まず、定義するコールバック関数の種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーのコールバック関数の種類のセットが用意されています。 コールバック関数の種類を使用して関数を宣言すると、ドライバー、静的ドライバー検証ツール (SDV)、およびその他の検証ツールのコード分析でエラーが検出され、Windows オペレーティング システム用のドライバーを記述するための要件になります。

たとえば、MyRequestImpersonate という名前の EvtRequestImpersonate コールバック関数を定義するには、次のコード例に示すように、EVT_WDF_REQUEST_IMPERSONATE型を使用します。

EVT_WDF_REQUEST_IMPERSONATE  MyRequestImpersonate;

次に、コールバック関数を次のように実装します。

_Use_decl_annotations_
VOID
 MyRequestImpersonate (
    WDFREQUEST  Request
    PVOID  Context
    )
  {...}

関数宣言の要件の詳細については、「 KMDF ドライバーの関数ロール型を使用した関数の宣言」を参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1
対象プラットフォーム	ユニバーサル
最小 UMDF バージョン	2.0
Header	wdfrequest.h (Wdf.h を含む)

こちらもご覧ください

WdfRequestImpersonate