windows网络适配器驱动开发-泛型分段卸载(下)

用于控制 GSO 的 INF 关键字

NetAdapterCx 检查注册表关键字，并在启用主动卸载功能时遵循它们。 驱动程序不需要采取任何进一步措施。

使用注册表值启用和禁用任务卸载中指定的 LSO 关键字可用于使用注册表项设置启用/禁用 LSO 卸载。

UDP 分段卸载（USO）中指定的 USO 关键字可用于通过注册表项设置启用/禁用 USO 卸载。

关键字值的类型必须为 REG_SZ。

配置 GSO

客户端驱动程序在网络适配器初始化期间首先声明其硬件的GSO功能。 在启动网络适配器之前，可能会在其 EvtDevicePrepareHardware 回调中发生此情况。

若要配置 GSO，请使用客户端驱动程序：

• 分配 NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES 结构。
• 调用 NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT 来初始化结构。
• 调用 NetAdapterOffloadSetGsoCapabilities 以向 NetAdapterCx 注册结构。

在调用 NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT 时，客户端驱动程序提供了一个指向 EVT_NET_ADAPTER_OFFLOAD_SET_GSO 回调的指针。 如果活动卸载功能发生更改，系统稍后将调用此回调。

指示硬件 GSO 功能的规则

以下规则适用于 NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES 结构：

• 驱动程序必须设置 Layer3Flags 和 Layer4Flags。
• 如果 NIC 支持 LSO，驱动程序必须使用 TCP 标志填充 Layer4Flags 字段 NetAdapterOffloadLayer4FlagTcpWithoutOptions 。
• 如果 NIC 支持 USO，驱动程序必须使用 UDP 标志填充 Layer4Flags 字段 NetAdapterOffloadLayer4FlagUdp 。
• MaximumOffloadSize 和 MinimumSegmentCount 是必填字段。
• Layer4OffsetLimit 字段是可选的。 如果 OS 发送标头偏移大于指定限制的数据包，则不会要求执行 GSO。
• 如果支持选项/扩展，则必须支持不带选项/扩展的 IP/TCP 数据包。

此示例演示客户端驱动程序如何设置其硬件卸载功能。

VOID MyAdapterSetOffloadCapabilities( NETADAPTER NetAdapter ) { // Configure the hardware's GSO offload capabilities NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES gsoOffloadCapabilities; auto const layer3Flags = NetAdapterOffloadLayer3FlagIPv4NoOptions | NetAdapterOffloadLayer3FlagIPv4WithOptions | NetAdapterOffloadLayer3FlagIPv6NoExtensions | NetAdapterOffloadLayer3FlagIPv6WithExtensions; auto const layer4Flags = NetAdapterOffloadLayer4FlagTcpNoOptions | NetAdapterOffloadLayer4FlagTcpWithOptions; NetAdapterOffloadLayer4FlagUdp; NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT( &gsoOffloadCapabilities, layer3Flags, layer4Flags, MY_GSO_OFFLOAD_MAX_SIZE, MY_GSO_OFFLOAD_MIN_SEGMENT_COUNT, EvtAdapterOffloadSetGso); gsoOffloadCapabilities.Layer4OffsetLimit = 127; // Set the current GSO offload capabilities and register the callback for future changes in active capabilities NetAdapterOffloadSetGsoCapabilities(NetAdapter, &gsoOffloadCapabilities); }

更新硬件卸载

如果 TCP/IP 堆栈或上层协议驱动程序请求更改网络适配器的有效功能，NetAdapterCx 将调用在适配器初始化期间注册的客户端驱动程序的 EVT_NET_ADAPTER_OFFLOAD_SET_GSO 回调。 在此函数中，系统在 NETOFFLOAD 对象中提供更新的功能，客户端驱动程序查询以更新其卸载功能。

客户端驱动程序可以调用以下函数来确定已启用哪些卸载：

• NetOffloadIsLsoIPv4Enabled
• NetOffloadIsLsoIPv6Enabled
• NetOffloadIsUsoIPv4Enabled
• NetOffloadIsUsoIPv6Enabled

以下示例演示客户端驱动程序如何更新其 GSO 卸载功能：

VOID MyEvtAdapterOffloadSetGso( NETADAPTER NetAdapter, NETOFFLOAD Offload ) { PMY_NET_ADAPTER_CONTEXT adapterContext = MyGetNetAdapterContext(NetAdapter); // Store the updated information in the context adapterContext->LSOv4 = NetOffloadIsLsoIPv4Enabled(Offload) ? GsoOffloadEnabled : GsoOffloadDisabled; adapterContext->LSOv6 = NetOffloadIsLsoIPv6Enabled(Offload) ? GsoOffloadEnabled : GsoOffloadDisabled; adapterContext->USOv4 = NetOffloadIsUsoIPv4Enabled(Offload) ? GsoOffloadEnabled : GsoOffloadDisabled; adapterContext->USOv6 = NetOffloadIsUsoIPv6Enabled(Offload) ? GsoOffloadEnabled : GsoOffloadDisabled; // Enable hardware checksum if LSO/USO is enabled MyUpdateHardwareChecksum(adapterContext); }