共用方式為

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

UCXUSBDEVICE_INIT 結構的指標，描述建立 USB 裝置對象的各種組態作業。 驅動程式會指定此結構中回呼函式的函式指標。 此結構是由UCX管理。

[in, optional] Attributes

呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標，指定 USB 裝置物件的屬性。

[out] UsbDevice

接收新 USB 裝置物件句柄之變數的指標。

傳回值

如果作業成功，此方法會傳回STATUS_SUCCESS。 否則，此方法可能會傳回一個適當的 NTSTATUS 錯誤碼。

言論

主機控制器的用戶端驅動程序必須在 WdfDeviceCreate 呼叫之後呼叫此方法。 新USB裝置物件的父系是UCX所指定的父中樞裝置。

如需程式代碼範例，請參閱 EVT_UCX_CONTROLLER_USBDEVICE_ADD。

要求

要求 價值
最低支援的用戶端 Windows 10
目標平臺 窗戶
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 ucxusbdevice.h （include Ucxclass.h）
IRQL PASSIVE_LEVEL

另請參閱

EVT_UCX_CONTROLLER_USBDEVICE_ADD