다음을 통해 공유


제네릭 구분 오프로드

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를 구성하려면 클라이언트 드라이버:

  1. NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES 구조를 할당합니다.

  2. NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT 호출하여 구조를 초기화합니다.

  3. NetAdapterOffloadSetGsoCapabilities를 호출하여 NetAdapterCx에 구조를 등록합니다.

NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT 호출하는 동안 클라이언트 드라이버는 EVT_NET_ADAPTER_OFFLOAD_SET_GSO 콜백에 대한 포인터를 제공합니다. 활성 오프로드 기능이 변경되면 시스템은 나중에 이 콜백을 호출합니다.

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

다음 규칙은 NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES 구조에 적용됩니다.

  1. 드라이버는 Layer3FlagsLayer4Flags를 설정해야 합니다.

  2. NIC가 LSO를 지원하는 경우 드라이버는 Layer4Flags 필드를 TCP 플래그로 NetAdapterOffloadLayer4FlagTcpWithoutOptions 채워야 합니다.

  3. NIC가 USO를 지원하는 경우 드라이버는 Layer4Flags 필드를 UDP 플래그로 NetAdapterOffloadLayer4FlagUdp 채워야 합니다.

  4. MaximumOffloadSizeMinimumSegmentCount 는 필수 필드입니다.

  5. Layer4OffsetLimit 필드는 선택 사항입니다. OS에서 헤더 오프셋이 지정된 한도보다 큰 패킷을 보내는 경우 GSO를 수행하도록 요청하지 않습니다.

  6. 옵션/확장이 지원되는 경우 옵션/확장이 없는 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);
}