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
目标平台 Windows
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 ucxusbdevice.h (包括 Ucxclass.h)
IRQL PASSIVE_LEVEL

另请参阅

EVT_UCX_CONTROLLER_USBDEVICE_ADD