функция обратного вызова EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE (udecxusbdevice.h)

Расширение класса эмуляции USB-устройства (UdeCx) вызывает эту функцию обратного вызова, чтобы изменить конфигурацию, выбрав альтернативный параметр, отключив текущие конечные точки или добавив динамические конечные точки.

Синтаксис

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;

VOID EvtUdecxUsbDeviceEndpointsConfigure(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] WDFREQUEST Request,
  [in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}

Параметры

[in] UdecxUsbDevice

Дескриптор объекта устройства UDE. Драйвер клиента создал этот объект в предыдущем вызове UdecxUsbDeviceCreate.

[in] Request

Дескриптор объекта запроса платформы, представляющий запрос.

[in] Params

Указатель на структуру UDECX_ENDPOINTS_CONFIGURE_PARAMS, описывающую параметры конфигурации.

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

Никакой

Замечания

Драйвер клиента зарегистрировал эту функцию обратного вызова в предыдущем вызове UdecxUsbDeviceInitSetStateChangeCallbacks путем указания указателя функции на его реализацию.

Расширение класса вызывает эту функцию обратного вызова, чтобы запросить драйвер клиента настроить одну или несколько новых конечных точек на оборудование и /или сообщает драйверу, когда одна или несколько существующих конечных точек больше не используется.

После создания конечных точек для каждой новой конечной точки драйвер клиента должен вызвать UdecxUsbEndpointSetWdfIoQueue перед завершением запроса.

После выпуска конечных точек драйвер клиента не должен использовать объекты очереди платформы, связанные с конечными точками. Расширение класса рассматривает эти очереди как очищаемые, чтобы предотвратить будущие запросы.

Расширение класса также может запрашивать новое значение конфигурации или альтернативный параметр с помощью этого обратного вызова.

Этот вызов является асинхронным. Драйвер клиента должен сигнализирует о завершении с состоянием, завершив запрос, переданный расширением класса.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10
минимальный поддерживаемый сервер Windows Server 2016
целевая платформа Виндоус
минимальная версия KMDF 1.15
заголовка udecxusbdevice.h (include Udecx.h)
IRQL <=DISPATCH_LEVEL

См. также

архитектура : эмуляция USB-устройств (UDE)

UdecxUsbEndpointSetWdfIoQueue

запись драйвера клиента UDE