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 要求を処理するために必要なさまざまなキューの処理など) を実行できるようになります。