Поделиться через

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