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 要求を処理するために必要なさまざまなキューを処理するなど、コントローラーとそのルートハブに関連する操作を実行できます。