Share via

NDIS_ENCAPSULATION_FORMAT (Compact 2013)

  • Article

3/26/2014

This structure is used for the EncapsulationFormat member of the NDIS_TASK_OFFLOAD_HEADER structure.

Syntax

typedef struct _NDIS_ENCAPSULATION_FORMAT {
  NDIS_ENCAPSULATION Encapsulation;
  struct {
    ULONG FixedHeaderSize:1;
    ULONG Reserved:31;
  } Flags;
  ULONG EncapsulationHeaderSize;
} NDIS_ENCAPSULATION_FORMAT,*PNDIS_ENCAPSULATION_FORMAT;

Members

  • Encapsulation
    Specifies the encapsulation type as one of the following NDIS_ENCAPSULATION values:

    Value

    Description

    UNSPECIFIED_Encapsulation

    An encapsulation type other than those listed here

    NULL_Encapsulation

    Reserved

    IEEE_802_3_Encapsulation

    IEEE 802.3 encapsulation (Ethernet_DIX)

    IEEE_802_5_Encapsulation

    IEEE 802.5 encapsulation

    LLC_SNAP_ROUTED_Encapsulation

    LLC encapsulation for routed protocols, as described in RFC 1483.

    Also used to indicate Ethernet LLC/SNAP encapsulation.

    LLC_SNAP_BRIDGE_Encapsulation

    Reserved
  • FixedHeaderSize
    This is always set to 1 to indicate that the encapsulation header is the same size in each packet.
  • Reserved
    Reserved
  • EncapsulationHeaderSize
    Specifies, in bytes, the size of the encapsulation header. The first IP header in the encapsulated transmit packet starts at this offset from the start of the packet.

Remarks

To support task offloads for a particular frame type, a miniport's network adapter must support the appropriate encapsulation types. The following table indicates which encapsulation types a miniport must support to be able to offload tasks for a given frame type.

Frame type

Encapsulation type

Ethernet

IEEE_802_3_Encapsulation

Token Ring

IEEE_802_5_Encapsulation

ATM (CLIP)

LLC_SNAP_ROUTED_Encapsulation

Other

UNSPECIFIED_Encapsulation

A network adapter does not have to support the same set of offload tasks for each encapsulation type. For example, an Ethernet network adapter can support checksum and Ipsec offloads for the IEEE_802_3_Encapsulation type (Ethernet DIX) but only checksum offloads for the LLC_SNAP_ROUTED_Encapsulation type.

A network adapter can offload the segmentation of large TCP packets only if one of the following is true:

  • It supports the encapsulation format specified by the TCP/IP protocol in the NDIS_TASK_OFFLOAD_HEADER structure.
  • The specified encapsulation type is UNSPECIFIED_Encapsulation and EncapsulationHeaderSize is set to the size of the encapsulation header for the media supported by the miniport and its network adapter.

The encapsulation format specified by the TCP/IP transport in the NDIS_TASK_OFFLOAD_HEADER structure applies to both send and receive packets that are passed to or from the TCP/IP transport through the network adapter. Only one encapsulation format is supported per network adapter at a time.

To disable all a network adapter's task-offload capabilities, the TCP/IP transport sets OID_TCP_TASK_OFFLOAD, passing only NDIS_TASK_OFFLOAD_HEADER in the information buffer. In this case, the TCP/IP transport sets the OffsetFirstTask member of NDIS_TASK_OFFLOAD_HEADER to zero.

Requirements

Header

ndis.h

See Also

Reference

NDIS 5.x Legacy Structures
NDIS_TASK_OFFLOAD_HEADER
NDIS_TASK_OFFLOAD
NDIS_REQUEST
NDIS_TASK_TCP_LARGE_SEND
NDIS_TASK_TCP_IP_CHECKSUM
OID_TCP_TASK_OFFLOAD
NDIS 5.x Legacy Reference