EVT_UCX_DEFAULT_ENDPOINT_UPDATE função de retorno de chamada (ucxendpoint.h)

Artigo
02/07/2025

A implementação do driver cliente que o UCX chama com informações sobre o ponto de extremidade padrão.

Sintaxe

EVT_UCX_DEFAULT_ENDPOINT_UPDATE EvtUcxDefaultEndpointUpdate;

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

Parâmetros

[in] UcxController

Um identificador para o controlador UCX que o driver cliente recebeu em uma chamada anterior para o método ucxControllerCreate.

[in] Request

Uma estrutura DEFAULT_ENDPOINT_UPDATE que contém o identificador para o ponto de extremidade padrão a ser atualizado.

Valor de retorno

Nenhum

Observações

O driver cliente UCX registra sua implementação de EVT_UCX_DEFAULT_ENDPOINT_UPDATE com a extensão do controlador de host USB (UCX) chamando o método UcxEndpointCreate.

O UCX normalmente chama essa rotina para atualizar o tamanho máximo do pacote do ponto de extremidade padrão. O driver cliente retorna o status de conclusão no WDFREQUEST, que pode ser concluído de forma assíncrona.

Exemplos

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);
}

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	ucxendpoint.h (inclua Ucxclass.h, Ucxendpoint.h)
IRQL	DISPATCH_LEVEL

Consulte também

UCX_DEFAULT_ENDPOINT_EVENT_CALLBACKS_INIT

UcxDefaultEndpointInitSetEventCallbacks

Partilhar via