EN
Este contenido no se encuentra disponible en su idioma, pero aquí tiene la versión en inglés.

NDIS_OFFLOAD_PARAMETERS structure

The NDIS_OFFLOAD_PARAMETERS structure specifies the current task offload configuration settings in response to an OID set request of OID_TCP_OFFLOAD_PARAMETERS.

Syntax


typedef struct _NDIS_OFFLOAD_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  UCHAR              IPv4Checksum;
  UCHAR              TCPIPv4Checksum;
  UCHAR              UDPIPv4Checksum;
  UCHAR              TCPIPv6Checksum;
  UCHAR              UDPIPv6Checksum;
  UCHAR              LsoV1;
  UCHAR              IPsecV1;
  UCHAR              LsoV2IPv4;
  UCHAR              LsoV2IPv6;
  UCHAR              TcpConnectionIPv4;
  UCHAR              TcpConnectionIPv6;
  ULONG              Flags;
#if (NDIS_SUPPORT_NDIS61)
  UCHAR              IPsecV2;
  UCHAR              IPsecV2IPv4;
#endif 
#if (NDIS_SUPPORT_NDIS630)
  struct {
    UCHAR RscIPv4;
    UCHAR RscIPv6;
  };
#endif 
#if (NDIS_SUPPORT_NDIS630)
  struct {
    UCHAR EncapsulatedPacketTaskOffload;
    UCHAR EncapsulationTypes;
  };
#endif 
} NDIS_OFFLOAD_PARAMETERS, *PNDIS_OFFLOAD_PARAMETERS;

Members

Header

The NDIS_OBJECT_HEADER structure for the NDIS_OFFLOAD_PARAMETERS structure. Set the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT.

To indicate the version of the NDIS_OFFLOAD_PARAMETERS structure, set the Revision member to one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_REVISION_3
3

Supports the RscIPv4 , RscIPv6, EncapsulatedPacketTaskOffload, and EncapsulationTypes members for NDIS 6.30.

Set the Size member to NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_3.

NDIS_OFFLOAD_PARAMETERS_REVISION_2
2

Supports the IPsecV2, IPsecV2IPv4, Reserved1, and Reserved2 members for NDIS 6.1.

Set the Size member to NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_2.

NDIS_OFFLOAD_PARAMETERS_REVISION_1
1

Original version for NDIS 6.0.

Set the Size member to NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_1.

 

IPv4Checksum

The IPv4 checksum setting of the miniport adapter. For more information, see the following Remarks section.

TCPIPv4Checksum

The IPv4 checksum setting of the miniport adapter for TCP packets. For more information, see the following Remarks section.

UDPIPv4Checksum

The IPv4 checksum setting of the miniport adapter for UDP packets. For more information, see the following Remarks section.

TCPIPv6Checksum

The IPv6 checksum setting of the miniport adapter for TCP packets. For more information, see the following Remarks section.

UDPIPv6Checksum

The IPv6 checksum setting of the miniport adapter for UDP packets. For more information, see the following Remarks section.

LsoV1

The large send offload version 1 (LSOV1) setting of the miniport adapter. This setting should be one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_LSOV1_DISABLED

LSOV1 is disabled.

NDIS_OFFLOAD_PARAMETERS_LSOV1_ENABLED

LSOV1 is enabled.

 

IPsecV1

The Internet protocol security (IPsec) offload setting of the miniport adapter. This setting should be one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_IPSECV1_DISABLED

IPsec offload is disabled.

NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_ENABLED

The IPsec offload Authentication Header (AH) feature should be enabled for transmit and receive.

NDIS_OFFLOAD_PARAMETERS_IPSECV1_ESP_ENABLED

The IPsec offload Encapsulating Security Payload (ESP) feature should be enabled for transmit and receive.

NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_AND_ESP_ENABLED

The IPsec offload AH and ESP features areenabled for transmit and receive.

 

LsoV2IPv4

The IPv4 large send offload version 2 (LSOV2) setting of the miniport adapter. This setting should be one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED

LSOV2 for IPv4 is disabled.

NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED

LSOV2 for IPv4 is enabled.

 

LsoV2IPv6

The IPv6 LSOV2 setting of the miniport adapter. These settings are specified as one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED

LSOV2 for IPv6 is disabled.

NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED

LSOV2 for IPv6 is enabled.

 

TcpConnectionIPv4

The IPv4 connection offload setting of the miniport adapter. These settings are specified as one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

 

TcpConnectionIPv6

The IPv6 connection offload setting of the miniport adapter. These settings are specified as one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

 

Flags

A set of flags that can be combined with a bitwise OR operation. Set this member to zero. There are currently no flags defined.

IPsecV2

The Internet protocol security (IPsec) offload version 2 setting of a miniport adapter that supports IPv6 and IPv4. This member specifies the setting for both IPv6 and IPv4 support. This setting should be one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED

IPsec offload version 2 is disabled.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED

The IPsec offload version 2 Authentication Header (AH) feature should be enabled for transmit and receive.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED

The IPsec offload version 2 Encapsulating Security Payload (ESP) feature should be enabled for transmit and receive.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED

The IPsec offload version 2A H and ESP features are enabled for transmit and receive.

 

IPsecV2IPv4

The Internet protocol security (IPsec) offload version 2 setting of a miniport adapter that supports IPv4 and does not support IPv6. If the miniport driver supports IPv6, the IPsecV2 member specifies the IPv4 setting and this member is not used. This setting should be one of the following values:

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED

IPsec offload version 2 is disabled.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED

The IPsec offload version 2 Authentication Header (AH) feature should be enabled for transmit and receive.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED

The IPsec offload version 2 Encapsulating Security Payload (ESP) feature should be enabled for transmit and receive.

NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED

The IPsec offload version 2A H and ESP features are enabled for transmit and receive.

 

RscIPv4

Indicates Receive Segment Coalescing state for IPv4.

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The RSC state is unchanged.

NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED

The RSC state is enabled.

NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED

The RSC state is disabled.

 

RscIPv6

Indicates Receive Segment Coalescing state for IPv6.

ValueMeaning
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The RSC state is unchanged.

NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED

The RSC state is enabled.

NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED

The RSC state is disabled.

 

EncapsulatedPacketTaskOffload

A protocol driver sets EncapsulatedPacketTaskOffload as follows:

Note  For receive side offloads such as VMQ and RSS, there are other set OIDs that the protocol driver sends down to enable and configure the offload parameters (for example, queues, hash, and indirection table). The EncapsulatedPacketTaskOffload member is supplemental to those OIDs and instructs the NIC to also do these offloads for encapsulated packets.

ValueMeaning
NDIS_OFFLOAD_SET_NO_CHANGE
0

The NVGRE task offload state is unchanged.

NDIS_OFFLOAD_SET_ON
1

Enables NVGRE task offloads.

NDIS_OFFLOAD_SET_OFF
2

Disables NVGRE task offloads.

 

EncapsulationTypes

This field is effective only when the EncapsulatedPacketTaskOffload is set to NDIS_OFFLOAD_SET_ON. If the EncapsulatedPacketTaskOffload member is not set to NDIS_OFFLOAD_SET_ON, this member is zero. A protocol driver must set EncapsulationTypes to the bitwise OR of the flags corresponding to encapsulation types that it requires. It can select flags from the following:

ValueMeaning
NDIS_ENCAPSULATION_TYPE_GRE_MAC
0x00000001

Specifies GRE MAC encapsulation (NVGRE).

 

Remarks

In response to an OID_TCP_OFFLOAD_PARAMETERS OID set request, a miniport driver uses the settings in the NDIS_OFFLOAD_PARAMETERS structure to set the current configuration of the miniport adapter.

NDIS retains the requested settings in the registry in the offload standardized keywords. When NDIS restarts the miniport adapter, the miniport driver reads the offload standardized keywords and uses them to set the default offload configuration of the NIC.

To access the checksum offload settings, use the following members of the NDIS_OFFLOAD_PARAMETERS structure:

IPv4Checksum

TCPIPv4Checksum

UDPIPv4Checksum

TCPIPv6Checksum

UDPIPv6Checksum

The preceding members can have one of the following values:

NDIS_OFFLOAD_PARAMETERS_NO_CHANGE

The miniport driver should not change the current setting.

NDIS_OFFLOAD_PARAMETERS_TX_RX_DISABLED

The feature that the member specifies is disabled.

NDIS_OFFLOAD_PARAMETERS_TX_ENABLED_RX_DISABLED

The feature that the member specifies is enabled for transmit and disabled for receive.

NDIS_OFFLOAD_PARAMETERS_RX_ENABLED_TX_DISABLED

The feature that the member specifies is enabled for receive and disabled for transmit.

NDIS_OFFLOAD_PARAMETERS_TX_RX_ENABLED

The feature that the member specifies is enabled for transmit and receive.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Version

Supported in NDIS 6.0 and later.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_OBJECT_HEADER
OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES
OID_TCP_OFFLOAD_PARAMETERS

 

 

Send comments about this topic to Microsoft

Mostrar:
© 2014 Microsoft