UcxEndpointCreate 函数 (ucxendpoint.h)

  • 项目

在指定的 USB 设备对象上创建终结点。

语法

NTSTATUS UcxEndpointCreate(
  [in]           UCXUSBDEVICE           UsbDevice,
  [out]          PUCXENDPOINT_INIT      *EndpointInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXENDPOINT            *Endpoint
);

参数

[in] UsbDevice

包含终结点的 USB 设备对象的句柄。 客户端驱动程序在上一次调用 UcxUsbDeviceCreate 时检索了句柄。

[out] EndpointInit

指向 UCXENDPOINT_INIT 结构的指针，该结构描述用于创建终结点对象的各种配置操作。 驱动程序在此结构中指定指向其回调函数的函数指针。 此结构由 UCX 管理。

[in, optional] Attributes

指向调用方分配 的WDF_OBJECT_ATTRIBUTES 结构的指针，该结构指定终结点对象的属性。

[out] Endpoint

指向接收新终结点对象的句柄的变量的指针。

返回值

如果操作成功，该方法将返回STATUS_SUCCESS。 否则，此方法可能会返回相应的 NTSTATUS 错误代码。

注解

主控制器的客户端驱动程序必须在 WdfDeviceCreate 调用后调用此方法。 新终结点对象的父对象是 USB 设备对象。

方法使用终结点类型、管道、传输和最大传输大小等信息初始化终结点对象。

有关代码示例，请参阅 EVT_UCX_USBDEVICE_ENDPOINT_ADD。

要求

要求 值
最低受支持的客户端 Windows 10
目标平台 Windows
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 ucxendpoint.h (包括 Ucxclass.h、Ucxendpoint.h)
IRQL PASSIVE_LEVEL