estrutura UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS (ucxcontroller.h)

Armazena as características de transporte em pontos relevantes no tempo. Essa estrutura é usada na função de retorno de chamada EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS.

Sintaxe

typedef struct _UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS {
  ULONG   TransportCharacteristicsFlags;
  ULONG64 CurrentRoundtripLatencyInMilliSeconds;
  ULONG64 MaxPotentialBandwidth;
} UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS, *PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS;

Membros

TransportCharacteristicsFlags

Uma máscara de bits que indica ao driver cliente as características de transporte que estão disponíveis e são retornadas nessa estrutura.

Se USB_TRANSPORT_CHARACTERISTICS_LATENCY_AVAILABLE

é definido, CurrentRoundtripLatencyInMilliSeconds contém informações válidas. Caso contrário, ele não deve ser usado pelo driver cliente.

Se USB_TRANSPORT_CHARACTERISTICS_BANDWIDTH_AVAILABLE

é definido, MaxPotentialBandwidth contém informações válidas. Caso contrário, ele não deve ser usado pelo driver do cliente.

CurrentRoundtripLatencyInMilliSeconds

Contém o atraso de ida e volta atual em milissegundos a partir do momento em que uma transferência não isócrona é recebida pela pilha de driver USB até o momento em que a transferência é concluída.

Para MA-USB, a rede subjacente pode ser WiFi, WiGig, Ethernet etc. O atraso pode variar dependendo das condições de rede subjacentes. Um driver de cliente deve consultar a latência periodicamente ou sempre que for notificado de uma alteração.

MaxPotentialBandwidth

Contém a largura de banda total do transporte compartilhado do controlador de host.

Para MA-USB, o transporte de rede subjacente pode ser WiFi, WiGig, Ethernet etc. A largura de banda total disponível pode variar dependendo de vários fatores, como o canal WiFi de negociação. Um driver de cliente deve consultar a largura de banda total periodicamente ou sempre que for notificado de uma alteração.

Requisitos

Confira também

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS