网环元素管理

按照本主题中的指南在网络数据传输期间管理NET_RING结构及其元素。本主题中的规则描述了在不同的数据路径方案下，客户端驱动程序可以修改哪些 net ring 元素的成员以及何时可以修改，并提供了客户端驱动程序在使用这些结构时应牢记的一般信息。

重要

客户端驱动程序应在开发的所有阶段遵循这些方向。如果在使用驱动程序验证程序进行测试时客户端驱动程序不遵循这些指示，驱动程序验证程序会报告冲突，并在测试的设备上触发 bug 检查。

NET_RING

启动NET_RING的父数据包队列时，环中的所有索引将初始化为 0。

下表描述了客户端驱动程序可以修改的 net ring 成员：

客户端驱动程序不得修改此结构中的任何只读成员，在调用EvtPacketQueueAdvance时，也绝不应将BeginIndex增加到超过EndIndex。

有关 net 环中的索引所有权的详细信息，请参阅net 环简介。

NET_PACKET

NET_PACKET中的字段对数据路径运行的不同上下文敏感。是否设置数据包的Ignore字段以及驱动程序是在接收（Rx）还是传输（Tx）数据包，会影响应用于该数据包的规则集。

下表为每种场景中的驱动程序提供指引：

关于Ignore字段的简要回顾

在 NetAdapterCx 数据路径中，Ignore字段用于标记应被跳过的数据包：

• Tx（传输）场景：Ignore由 NetAdapterCx 框架设置，用于指示驱动程序应跳过该数据包的传输（例如，数据包已被上层取消）。驱动程序仅可读取此字段。

• Rx（接收）场景：Ignore由客户端驱动程序在取消操作期间设置，用于指示框架应忽略该数据包（例如，该数据包从未真正被硬件填充）。驱动程序负责写入此字段，框架负责读取并执行相应操作。

NET_PACKET 布局（Layout）字段

在 Rx 操作期间，NET_PACKET的Layout字段受以下规则的约束：

注意：Tx 期间不使用Layout字段。

NET_FRAGMENT

NET_FRAGMENT字段规则取决于驱动程序是接收还是传输，以及片段缓冲区是由驱动程序还是框架附加到数据包：

关键规则速查表