função de retorno de chamada EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS (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 do cliente para o controlador host preenche com características de transporte.

Retornar valor

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

Comentários

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

Confira também

UcxControllerCreate