Функция 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.

Требования