Функция UdecxUsbDeviceInitSetEndpointsType (udecxusbdevice.h)

Статья
08/07/2023

Указывает тип конечной точки (простой или динамической) в параметрах инициализации, которые драйвер клиента использует для создания виртуального USB-устройства.

Синтаксис

void UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

Параметры

[in, out] UdecxUsbDeviceInit

Указатель на структуру, выделенную WDF, которая содержит параметры инициализации для виртуального USB-устройства. Драйвер клиента извлек этот указатель при предыдущем вызове UdecxUsbDeviceInitAllocate.

[in] UdecxEndpointType

Значение типа UDECX_ENDPOINT_TYPE, указывающее тип конечной точки USB.

Возвращаемое значение

None

Remarks

Перед созданием виртуального USB-устройства драйвер клиента должен указать поддерживаемый тип конечной точки. Он может поддерживать один из двух типов (определенных в UDECX_ENDPOINT_TYPE):

Простая конечная точка . Драйвер клиента создает все объекты конечных точек перед подключением устройства. Устройство должно иметь только одну конфигурацию и один параметр интерфейса для каждого интерфейса.
Динамическая конечная точка — клиент создает объекты конечных точек в функции обратного вызова EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE . Расширение класса эмуляции USB-устройства (UdeCx) вызывает реализацию драйвера при получении запроса на добавление или настройку конечных точек.

UdecxUsbDeviceInit — это непрозрачная структура, содержащая указатели на функции обратного вызова, связанные с конечными точками. Если драйвер клиента поддерживает динамические конечные точки, эти функции обратного вызова должны быть реализованы драйвером:

Перед вызовом этого метода драйвер клиента должен задать эти указатели, вызвав UdecxUsbDeviceInitSetStateChangeCallbacks.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Windows
Минимальная версия KMDF	1.15
Верхняя часть	udecxusbdevice.h (включая Udecx.h)
Библиотека	Udecxstub.lib
IRQL	PASSIVE_LEVEL