UcxUsbDeviceCreate 関数 (ucxusbdevice.h)

指定したコントローラーに USB デバイス オブジェクトを作成します。

構文

NTSTATUS UcxUsbDeviceCreate(
  [in]           UCXCONTROLLER          Controller,
  [out]          PUCXUSBDEVICE_INIT     *UsbDeviceInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXUSBDEVICE           *UsbDevice
);

パラメーター

[in] Controller

コントローラー オブジェクトへのハンドル。 クライアント ドライバーは 、UcxControllerCreate の以前の呼び出しでハンドルを取得しました。

[out] UsbDeviceInit

USB デバイス オブジェクトを作成するためのさまざまな構成操作を記述する UCXUSBDEVICE_INIT 構造体へのポインター。 ドライバーは、この構造体内のコールバック関数への関数ポインターを指定します。 この構造は UCX によって管理されます。

[in, optional] Attributes

USB デバイス オブジェクトの属性を指定する呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。

[out] UsbDevice

新しい USB デバイス オブジェクトへのハンドルを受け取る変数へのポインター。

戻り値

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

注釈

ホスト コントローラーのクライアント ドライバーは、 WdfDeviceCreate 呼び出しの後にこのメソッドを呼び出す必要があります。 新しい USB デバイス オブジェクトの親は、UCX で指定された親ハブ デバイスです。

コード例については、「 EVT_UCX_CONTROLLER_USBDEVICE_ADD」を参照してください。

要件

要件
サポートされている最小のクライアント Windows 10
対象プラットフォーム Windows
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header ucxusbdevice.h (Ucxclass.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

EVT_UCX_CONTROLLER_USBDEVICE_ADD