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

Статья
08/07/2023

Реализация драйвера клиента, которую UCX вызывает для настройки конечных точек в контроллере.

Синтаксис

EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE EvtUcxUsbdeviceEndpointsConfigure;

void EvtUcxUsbdeviceEndpointsConfigure(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

Параметры

[in] UcxController

Дескриптор контроллера UCX, который драйвер клиента получил при предыдущем вызове метода UcxControllerCreate .

[in] Request

Содержит структуру типа ENDPOINTS_CONFIGURE структуру.

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

None

Remarks

Драйвер клиента UCX регистрирует эту функцию обратного вызова в расширении КОНТРОЛЛЕРа узла USB (UCX), вызывая метод UcxUsbDeviceCreate .

В обратном вызове драйвер программирует или отменяет программирование конечных точек, как описано в структуре ENDPOINTS_CONFIGURE .

Этот обратный вызов не включает и не отключает конечную точку по умолчанию. Состояние конечной точки по умолчанию привязано к состоянию устройства. Драйвер реализует операции включения и отключения в функциях обратного вызова EVT_UCX_USBDEVICE_DISABLE и EVT_UCX_USBDEVICE_ENABLE .

Драйвер клиента возвращает состояние завершения в поле Запрос. Драйвер может выполнять WDFREQUEST асинхронно.

Примеры

VOID
UsbDevice_EvtUcxUsbDeviceEndpointsConfigure(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEndpointsConfigure");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);

    ...

    endpointsConfigure = (PENDPOINTS_CONFIGURE)wdfRequestParams.Parameters.Others.Arg1;

    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Требования

Требование	Значение
Целевая платформа	Windows
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	ucxusbdevice.h (включая Ucxclass.h)
IRQL	DISPATCH_LEVEL

См. также раздел

ENDPOINTS_CONFIGURE

UcxUsbDeviceCreate

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