Estrutura de mensagens WiFiCx
As mensagens de comando WiFiCx são baseadas nos comandos anteriores do modelo WDI.
Todas as mensagens de comando Wi-Fi devem começar com uma estrutura WDI_MESSAGE_HEADER . O cabeçalho de comando é seguido por zero ou mais estruturas TLV (type-length-value).
As IDs de mensagem de comando definidas para mensagens enviadas do host para o dispositivo Wi-Fi são documentadas em OIDs de Tarefa WiFiCx, OIDs de Propriedade WiFiCx e indicações de status WiFiCx.
TLVs
A estrutura de TLVs é definida na tabela a seguir. Os dados em TLVs estão em ordem de bytes little-endian.
| Campo | Tipo | Descrição |
|---|---|---|
| Type | UINT16 | O tipo da estrutura TLV. Tipos de TLV não reconhecidos devem ser ignorados sem disparar erros. |
| Comprimento do buffer de valor | UINT16 | O tamanho do buffer Valor em bytes. |
| Valor | BYTE[*] | O buffer de carga, que pode conter uma estrutura, uma lista de estruturas ou outras TLVs. Se houver mais dados do que o esperado em um TLV, os dados adicionais deverão ser ignorados sem disparar erros. |
Há dois tipos de agrupamentos TLV: listas TLV dimensionadas estaticamente e grupos multi-TLV.
Listas TLV dimensionadas estaticamente
As listas TLV de tamanho estatica contêm vários membros de tamanho estatica. Eles são análogos a matrizes de estilo C padrão.
Neste exemplo, WDI_TLV_UNICAST_ALGORITHM_LIST é definido como uma lista de WDI_ALGO_PAIRS.
Tipo: WDI_TLV_UNICAST_ALGORITHM_LIST
Comprimento: N * sizeof(WDI_ALGO_PAIRS)
Valor: WDI_ALGO_PAIRS[N]
Esse uso é especificado nos tópicos de referência TLV com notação de matriz.
Grupos multi-TLV
Quando o tamanho de um determinado objeto não é conhecido antecipadamente, grupos de vários TLV são usados. Esse padrão de uso especifica que N TLVs de tamanho variavelmente diferentes são esperadas em um determinado buffer. O número de entradas (N) não é conhecido antecipadamente e é inferido pelo número de TLVs correspondentes no buffer fornecido.
Neste exemplo, o buffer pai é um WDI_MESSAGE_HEADER, que define o final do buffer TLV. Observe que WDI_TLV_BSS_ENTRY pode ser intercalado entre outros tipos diferentes de TLV no buffer pai.
| Deslocamento | Campo | Type |
|---|---|---|
| 0 | WDI_MESSAGE_HEADER | Cabeçalho da mensagem |
| sizeof(WDI_MESSAGE_HEADER) | TLV₀ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
| TLV₀ + L₀ + sizeof(Cabeçalho TLV) | TLV₁ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
| TLV₁ + L₁ + sizeof(Cabeçalho TLV) | TLV₂ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
| TLV₂ + L₂ + sizeof(Cabeçalho TLV) | TLV₃ (OTHER_TLV_TYPE) | Algum outro tipo de TLV |
| TLV₃ + L₃ + sizeof(Cabeçalho TLV) | TLV₄ (WDI_TLV_BSS_ENTRY) | WDI_BSS_ENTRY |
Para TLVs que contêm outras TLVs, os tópicos de referência TLV têm uma coluna de várias instâncias TLV permitidas . Se essa coluna for verificada, o TLV especificado poderá aparecer várias vezes. Para obter um exemplo disso, consulte WDI_TLV_CONNECT_PARAMETERS.