NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT function (netadapter.h)

Article
02/22/2024

The NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT function initializes a NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES structure.

Syntax

void NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT(
  [_Out_] NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES *GsoCapabilities,
  [_In_]  NET_ADAPTER_OFFLOAD_LAYER3_FLAGS     Layer3Flags,
  [_In_]  NET_ADAPTER_OFFLOAD_LAYER4_FLAGS     Layer4Flags,
  [_In_]  SIZE_T                               MaximumOffloadSize,
  [_In_]  SIZE_T                               MinimumSegmentCount,
  [_In_]  PFN_NET_ADAPTER_OFFLOAD_SET_GSO      EvtAdapterOffloadSetGso
);

Parameters

[_Out_] GsoCapabilities

A pointer to a driver-allocated NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES structure.

[_In_] Layer3Flags

Flags specifying the layer 3 protocols and variations contained in packets that the NIC can successfully segment.

[_In_] Layer4Flags

Flags specifying the layer 4 protocols and variations contained in packets that the NIC can successfully segment.

[_In_] MaximumOffloadSize

The maximum bytes of user data that the transport can pass to the NIC driver in a single packet.

[_In_] MinimumSegmentCount

The minimum number of segments by which a large TCP packet must be divisible before the transport can offload it to the hardware for segmentation.

[_In_] EvtAdapterOffloadSetGso

A pointer to the client driver's implementation of the EVT_NET_ADAPTER_OFFLOAD_SET_GSO callback function.

Return value

None

Remarks

The client driver calls NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES_INIT to initialize a NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES structure. The driver passes the initialized NET_ADAPTER_OFFLOAD_GSO_CAPABILITIES structure as a parameter to the NetAdapterOffloadSetGsoCapabilities function to register it.

Requirements

Requirement	Value
Minimum supported client	Windows 11
Minimum supported server	Windows Server 2022
Target Platform	Universal
Minimum KMDF version	1.29
Header	netadapter.h (include netadaptercx.h)
Library	netadaptercxstub.lib