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 |