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

Статья
02/07/2025

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

Синтаксис

EVT_UCX_DEFAULT_ENDPOINT_UPDATE EvtUcxDefaultEndpointUpdate;

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

Параметры

[in] UcxController

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

[in] Request

Структура DEFAULT_ENDPOINT_UPDATE, содержащая дескриптор конечной точки по умолчанию для обновления.

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

Никакой

Замечания

Драйвер клиента UCX регистрирует свою реализацию EVT_UCX_DEFAULT_ENDPOINT_UPDATE с расширением контроллера USB-узла (UCX), вызвав метод UcxEndpointCreate.

UCX обычно вызывает эту подпрограмму для обновления максимального размера пакета конечной точки по умолчанию. Драйвер клиента возвращает состояние завершения в WDFREQUEST, которое может выполняться асинхронно.

Примеры

VOID
Endpoint_EvtUcxDefaultEndpointUpdate(
    UCXCONTROLLER   UcxController,
    WDFREQUEST      Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, Endpoint, "Endpoint_EvtUcxDefaultEndpointUpdate");

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

    defaultEndpointUpdate = (PDEFAULT_ENDPOINT_UPDATE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Требования

Требование	Ценность
целевая платформа	Виндоус
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL	DISPATCH_LEVEL

См. также

UCX_DEFAULT_ENDPOINT_EVENT_CALLBACKS_INIT

UcxDefaultEndpointInitSetEventCallbacks

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