GSO(제네릭 세그먼트화 오프로드)는 LSO(대규모 송신 오프로드) 및 USO(UDP 송신 오프로드)를 집합적으로 나타냅니다.
클라이언트 드라이버는 네트워크 매체의 최대 전송 단위(MTU)보다 큰 TCP/UDP 패킷의 분할을 오프로드할 수 있습니다. 드라이버는 GSO API를 사용하여 NetAdapterCx에 이 기능을 표시해야 합니다.
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를 지원하는 경우 드라이버는 Layer4Flags 필드를
NetAdapterOffloadLayer4FlagTcpWithoutOptionsTCP 플래그로 채워야 합니다.NIC에서 USO를 지원하는 경우 드라이버는 Layer4Flags 필드를
NetAdapterOffloadLayer4FlagUdpUDP 플래그로 채워야 합니다.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);
}