WiFiCx 消息结构

WiFiCx 命令消息基于以前的 WDI 模型命令。

所有Wi-Fi命令消息都必须以 WDI_MESSAGE_HEADER 结构开头。命令标头后跟零个或多个 type-length-value (TLV) 结构。

为从主机发送到Wi-Fi设备的消息定义的命令消息 ID 记录在 WiFiCx 任务 OID、 WiFiCx 属性 OID 和 WiFiCx 状态指示中。

TLV

下表中定义了 TLV 的结构。 TLV 中的数据按 little-endian 字节顺序排列。

字段	类型	说明
类型	UINT16	TLV 结构的类型。必须跳过无法识别的 TLV 类型，而不会触发错误。
值缓冲区的长度	UINT16	值缓冲区的大小（以字节为单位）。
值	BYTE[*]	有效负载缓冲区，可能包含结构、结构列表或其他 TLV。如果 TLV 中的数据超出预期，则应跳过其他数据而不会触发错误。

有两种类型的 TLV 分组：静态大小的 TLV 列表和多 TLV 组。

静态大小的 TLV 列表包含多个静态大小的成员。它们类似于标准 C 样式数组。

在此示例中， WDI_TLV_UNICAST_ALGORITHM_LIST 定义为WDI_ALGO_PAIRS列表。

类型：WDI_TLV_UNICAST_ALGORITHM_LIST

长度：N * sizeof (WDI_ALGO_PAIRS)

值：WDI_ALGO_PAIRS[N]

此用法在 TLV 参考主题中使用数组表示法指定。

如果事先不知道给定对象的大小，则使用多 TLV 组。此使用模式指定在给定缓冲区中应有 N 个不同的可变大小的 TLV。 (N) 的条目数事先未知，并且由给定缓冲区中匹配的 TLV 数推断。

在此示例中，父缓冲区是定义 TLV 缓冲区末尾的 WDI_MESSAGE_HEADER。请注意， WDI_TLV_BSS_ENTRY 可能穿插在父缓冲区中的其他不同 TLV 类型之间。

对于包含其他 TLV 的 TLV，TLV 参考主题具有 “允许多个 TLV 实例” 列。如果选中此列，则允许指定 TLV 出现多次。有关此示例，请参阅 WDI_TLV_CONNECT_PARAMETERS。