EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS função de retorno de chamada (ucxcontroller.h)

O UCX invoca esse retorno de chamada para recuperar as características do controlador de host.

Sintaxe

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

Parâmetros

[in] UcxController

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

[out] UcxControllerTransportCharacteristics

Um ponteiro para uma estrutura UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS que o driver cliente do controlador de host preenche com características de transporte.

Valor de retorno

Se a operação for bem-sucedida, a função de retorno de chamada deverá retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele deverá retornar um valor de status para o qual NT_SUCCESS(status) é igual a FALSE.

Observações

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

Essa função de retorno de chamada é opcional. Sempre que as características de transporte são alteradas, o driver cliente é responsável por notificar o UCX de que uma das características foi alterada usando uma nova função UcxControllerNotifyTransportCharacteristicsChange.

Requisitos

Consulte também

UcxControllerCreate