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

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

[out] UsbDevice

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

傳回值

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

備註

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

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

規格需求

需求 值
最低支援的用戶端 Windows 10
目標平台 Windows
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 ucxusbdevice.h (包含 Ucxclass.h)
IRQL PASSIVE_LEVEL

另請參閱

EVT_UCX_CONTROLLER_USBDEVICE_ADD