UdecxWdfDeviceAddUsbDeviceEmulation 関数 (udecxwdfdevice.h)

  • [アーティクル]

ホスト コントローラーと、コントローラーに接続されている仮想 USB デバイスに関連する操作をサポートするように、フレームワーク デバイス オブジェクトを初期化します。

構文

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

パラメーター

WdfDevice

WdfDeviceCreate の前回の呼び出しでクライアント ドライバーが取得したフレームワーク デバイス オブジェクトへのハンドル。

[in] Config

UDECX_WDF_DEVICE_CONFIG_INIT を呼 び出してクライアント ドライバーが初期化した UDECX_WDF_DEVICE_CONFIG構造体へのポインター。

戻り値

メソッドは、操作が成功した場合STATUS_SUCCESSを返します。 それ以外の場合、このメソッドは適切な NTSTATUS エラー コードを返す可能性があります。

注釈

エミュレートされたホスト コントローラーと USB デバイスの UDE クライアント ドライバーは、 WdfDeviceCreate 呼び出しの後にこのメソッドを呼び出す必要があります。

この呼び出し中に、クライアント ドライバーが提供するイベント コールバックの実装も登録されます。 UDECX_WDF_DEVICE_CONFIGの適切なメンバーの設定を呼び出して、これらの関数への関数ポインター を指定します。

メソッドを使用すると、フレームワーク デバイス オブジェクトは、コントローラーとそのルート ハブに関連する操作 (接続されている USB デバイスに送信される IOCTL 要求を処理するために必要なさまざまなキューの処理など) を実行できるようになります。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー Windows Server 2016
対象プラットフォーム Windows
最小 KMDF バージョン 1.15
Header udecxwdfdevice.h (Udecx.h を含む)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

アーキテクチャ:USB デバイス エミュレーション (UDE)

UDE クライアント ドライバーを記述する