제네릭 구분 오프로드

아티클
06/15/2023

GSO(제네릭 구분 오프로드)는 LSO(대규모 송신 오프로드) 및 UDP USO(송신 오프로드)를 전체적으로 나타냅니다.

클라이언트 드라이버는 네트워크 매체의 최대 전송 단위(MTU)보다 큰 TCP/UDP 패킷의 구분을 오프로드할 수 있습니다. 드라이버는 GSO API를 사용하여 NetAdapterCx에 이 기능을 표시해야 합니다.

GSO를 제어하기 위한 INF 키워드

NetAdapterCx는 레지스트리 키워드를 확인하고 활성 오프로드 기능을 사용하도록 설정할 때 해당 키워드를 적용합니다. 드라이버는 추가 작업을 수행할 필요가 없습니다.

레지스트리 값을 사용하여 작업 오프로드 사용 및 사용 안 함에서 지정된 LSO 키워드를 사용하여 레지스트리 키 설정으로 LSO 오프로드를 사용하거나 사용하지 않도록 설정할 수 있습니다.

UDP USO(Segmentation Offload)에 지정된 USO 키워드를 사용하여 레지스트리 키 설정으로 USO 오프로드를 사용하거나 사용하지 않도록 설정할 수 있습니다.

키워드(keyword) 값은 REG_SZ 형식이어야 합니다.

GSO 구성

클라이언트 드라이버는 먼저 순 어댑터를 초기화하는 동안 하드웨어의 GSO 기능을 보급합니다. 이 문제는 Net 어댑터를 시작하기 전에 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 필드를 TCP 플래그로 NetAdapterOffloadLayer4FlagTcpWithoutOptions 채워야 합니다.
NIC가 USO를 지원하는 경우 드라이버는 Layer4Flags 필드를 UDP 플래그로 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 스택 또는 지나치게 많은 프로토콜 드라이버가 net 어댑터의 활성 기능 변경을 요청하는 경우 NetAdapterCx는 어댑터 초기화 중에 등록된 클라이언트 드라이버의 EVT_NET_ADAPTER_OFFLOAD_SET_GSO 콜백을 호출합니다. 이 함수에서 시스템은 클라이언트 드라이버가 오프로드 기능을 업데이트하기 위해 쿼리하는 NETOFFLOAD 개체에서 업데이트된 기능을 제공합니다.

클라이언트 드라이버는 다음 함수를 호출하여 사용하도록 설정된 오프로드를 확인할 수 있습니다.

다음 예제에서는 클라이언트 드라이버가 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);
}

다음을 통해 공유

제네릭 구분 오프로드

GSO를 제어하기 위한 INF 키워드

GSO 구성

하드웨어 GSO 기능을 나타내는 규칙

하드웨어 오프로드 업데이트

피드백

피드백

추가 리소스