estrutura USB_TRANSPORT_CHARACTERISTICS (usbioctl.h)

Armazena as características de transporte em pontos relevantes no tempo. Essa estrutura é usada na solicitação IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS .

Sintaxe

typedef struct _USB_TRANSPORT_CHARACTERISTICS {
  ULONG   Version;
  ULONG   TransportCharacteristicsFlags;
  ULONG64 CurrentRoundtripLatencyInMilliSeconds;
  ULONG64 MaxPotentialBandwidth;
} USB_TRANSPORT_CHARACTERISTICS, *PUSB_TRANSPORT_CHARACTERISTICS;

Membros

Version

A versão é definida como USB_TRANSPORT_CHARACTERISTICS_VERSION_1.

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 cliente.

CurrentRoundtripLatencyInMilliSeconds

Contém o atraso de ida e volta atual em milissegundos desde o momento em que uma transferência não isocrona é 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 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

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709
Servidor mínimo com suporte Windows Server 2016
Cabeçalho usbioctl.h

Confira também

IOCTL_USB_GET_TRANSPORT_CHARACTERISTICS