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