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 hardwares 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 对象中提供更新的功能客户端驱动程序查询以更新其卸载功能。客户端驱动程序可以调用以下函数来确定已启用哪些卸载NetOffloadIsLsoIPv4EnabledNetOffloadIsLsoIPv6EnabledNetOffloadIsUsoIPv4EnabledNetOffloadIsUsoIPv6Enabled以下示例演示客户端驱动程序如何更新其 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); }