次の方法で共有

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 関数型に適用される注釈が使用されます。

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

  • ドライバーが ImpersonationLevel = SecurityIdentificationWdfRequestImpersonate を呼び出すと、コールバックは 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
ヘッダー wdfrequest.h (Wdf.h を含む)

関連項目

WdfRequestImpersonate の