estructura NDIS_OFFLOAD_PARAMETERS (ntddndis.h)

Artículo
05/23/2024

La estructura NDIS_OFFLOAD_PARAMETERS especifica los valores de configuración de descarga de tareas actuales en respuesta a una solicitud de conjunto de OID de OID_TCP_OFFLOAD_PARAMETERS.

Sintaxis

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;
  UCHAR                              IPsecV2;
  UCHAR                              IPsecV2IPv4;
  struct {
    UCHAR RscIPv4;
    UCHAR RscIPv6;
  };
  struct {
    UCHAR EncapsulatedPacketTaskOffload;
    UCHAR EncapsulationTypes;
  };
  union {
    struct {
      USHORT VxlanUDPPortNumber;
    } VxlanParameters;
    ULONG Value;
  } EncapsulationProtocolParameters;
  _ENCAPSULATION_PROTOCOL_PARAMETERS _ENCAPSULATION_PROTOCOL_PARAMETERS;
  struct {
    UCHAR IPv4;
    UCHAR IPv6;
  } UdpSegmentation;
  struct {
    UCHAR Enabled;
  } UdpRsc;
} NDIS_OFFLOAD_PARAMETERS, *PNDIS_OFFLOAD_PARAMETERS;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura de NDIS_OFFLOAD_PARAMETERS . Establezca el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_DEFAULT.

Para indicar la versión de la estructura NDIS_OFFLOAD_PARAMETERS , establezca el miembro Revision en uno de los valores siguientes:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_REVISION_6 6	Admite el miembro UdpRsc para NDIS 6.89. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_6.
NDIS_OFFLOAD_PARAMETERS_REVISION_5 5	Admite udpSegmentation para IPv4 e IPv6 para NDIS 6.83. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_5.
NDIS_OFFLOAD_PARAMETERS_REVISION_4 4	Admite EncapsulationProtocolParameters y sus VxlanParameters anidados para NDIS 6.50. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_4.
NDIS_OFFLOAD_PARAMETERS_REVISION_3 3	Admite los miembros RscIPv4, RscIPv6, EncapsulatedPacketTaskOffload y EncapsulationTypes para NDIS 6.30. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_3.
NDIS_OFFLOAD_PARAMETERS_REVISION_2 2	Admite los miembros IPsecV2, IPsecV2IPv4, Reserved1 y Reserved2 para NDIS 6.1. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_2.
NDIS_OFFLOAD_PARAMETERS_REVISION_1 1	Versión original de NDIS 6.0. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_1.

IPv4Checksum

La configuración de suma de comprobación IPv4 del adaptador de minipuerto. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

TCPIPv4Checksum

La configuración de suma de comprobación IPv4 del adaptador de minipuerto para paquetes TCP. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

UDPIPv4Checksum

La configuración de suma de comprobación IPv4 del adaptador de minipuerto para paquetes UDP. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

TCPIPv6Checksum

La configuración de suma de comprobación IPv6 del adaptador de miniporte para paquetes TCP. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

UDPIPv6Checksum

La configuración de suma de comprobación IPv6 del adaptador de miniporte para paquetes UDP. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

LsoV1

El valor de la versión 1 (LSOV1) de envío grande del adaptador de minipuerto. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_LSOV1_DISABLED	LSOV1 está deshabilitado.
NDIS_OFFLOAD_PARAMETERS_LSOV1_ENABLED	LSOV1 está habilitado.

IPsecV1

La configuración de descarga de seguridad del protocolo de Internet (IPsec) del adaptador de minipuerto. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_IPSECV1_DISABLED	La descarga de IPsec está deshabilitada.
NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_ENABLED	La característica IPsec descargar encabezado de autenticación (AH) debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV1_ESP_ENABLED	La característica Carga de carga de seguridad (ESP) de IPsec debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV1_AH_AND_ESP_ENABLED	Las características de AH y ESP de descarga de IPsec están habilitadas para la transmisión y recepción.

LsoV2IPv4

La configuración IPv4 large send offload versión 2 (LSOV2) del adaptador de miniport. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED	LSOV2 para IPv4 está deshabilitado.
NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED	LSOV2 para IPv4 está habilitado.

LsoV2IPv6

Configuración IPv6 LSOV2 del adaptador de minipuerto. Esta configuración se especifica como uno de los valores siguientes:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_LSOV2_DISABLED	LSOV2 para IPv6 está deshabilitado.
NDIS_OFFLOAD_PARAMETERS_LSOV2_ENABLED	LSOV2 para IPv6 está habilitado.

TcpConnectionIPv4

Configuración de descarga de conexión IPv4 del adaptador de minipuerto. Esta configuración se especifica como uno de los valores siguientes:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.

TcpConnectionIPv6

Configuración de descarga de conexión IPv6 del adaptador de minipuerto. Esta configuración se especifica como uno de los valores siguientes:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.

Flags

Conjunto de marcas que se pueden combinar con una operación OR bit a bit. Establezca este miembro en cero o en el siguiente valor:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_SKIP_REGISTRY_UPDATE 0x00000001	Permite deshabilitar la descarga de descarga de segmento de recepción UDP (URO) solo en tiempo de ejecución. Los cambios realizados con esta marca no se guardan en el Registro.

IPsecV2

La configuración de descarga de la versión 2 de seguridad del protocolo de Internet (IPsec) de un adaptador de miniporte que admita IPv6 e IPv4. Este miembro especifica la configuración de compatibilidad con IPv6 e IPv4. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED	La descarga de IPsec versión 2 está deshabilitada.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED	La característica IPsec offload version 2 Authentication Header (AH) debe estar habilitada para transmitir y recibir.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED	La característica IPsec offload version 2 Encapsulating Security Payload (ESP) debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED	Las características de descarga de IPsec versión 2 AH y ESP están habilitadas para la transmisión y recepción.

IPsecV2IPv4

La configuración de descarga de la versión 2 de seguridad del protocolo de Internet (IPsec) de un adaptador de miniporte que admite IPv4 y no admite IPv6. Si el controlador de minipuerto admite IPv6, el miembro IPsecV2 especifica la configuración IPv4 y este miembro no se usa. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_DISABLED	La descarga de IPsec versión 2 está deshabilitada.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_ENABLED	La característica IPsec offload version 2 Authentication Header (AH) debe estar habilitada para transmitir y recibir.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED	La característica IPsec offload version 2 Encapsulating Security Payload (ESP) debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED	Las características de descarga de IPsec versión 2 AH y ESP están habilitadas para la transmisión y recepción.

RscIPv4

Indica el estado de fusión del segmento de recepción para IPv4.

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El estado rsc no cambia.
NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED	El estado RSC está habilitado.
NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED	El estado RSC está deshabilitado.

RscIPv6

Indica el estado de fusión del segmento de recepción para IPv6.

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El estado rsc no cambia.
NDIS_OFFLOAD_PARAMETERS_RSC_ENABLED	El estado RSC está habilitado.
NDIS_OFFLOAD_PARAMETERS_RSC_DISABLED	El estado RSC está deshabilitado.

EncapsulatedPacketTaskOffload

Un controlador de protocolo establece EncapsulatedPacketTaskOffload de la siguiente manera:

Nota: Para las descargas laterales de recepción, como VMQ y RSS, hay otros OID establecidos que el controlador de protocolo envía para habilitar y configurar los parámetros de descarga (por ejemplo, colas, hash e tabla de direccionamiento indirecto). El miembro EncapsulatedPacketTaskOffload es complementario a esos OID e indica a la NIC que también realice estas descargas para paquetes encapsulados.

Valor	Significado
NDIS_OFFLOAD_SET_NO_CHANGE 0	Los estados de descarga de la tarea NVGRE y VXLAN no cambian.
NDIS_OFFLOAD_SET_ON 1	Habilita las descargas de tareas NVGRE y VXLAN.
NDIS_OFFLOAD_SET_OFF 2	Deshabilita las descargas de tareas NVGRE y VXLAN.

EncapsulationTypes

Este campo solo es efectivo cuando EncapsulatedPacketTaskOffload está establecido en NDIS_OFFLOAD_SET_ON. Si el miembro EncapsulatedPacketTaskOffload no está establecido en NDIS_OFFLOAD_SET_ON, este miembro es cero. Un controlador de protocolo debe establecer EncapsulationTypes en el OR bit a bit de las marcas correspondientes a los tipos de encapsulación que requiere. Puede seleccionar marcas de lo siguiente:

Valor	Significado
NDIS_ENCAPSULATION_TYPE_GRE_MAC 0x00000001	Especifica la encapsulación GRE MAC (NVGRE).
NDIS_ENCAPSULATION_TYPE_VXLAN 0x00000002	Especifica la encapsulación de VXLAN.

EncapsulationProtocolParameters

Unión que describe los parámetros de encapsulación de VXLAN.

Si el controlador de minipuerto anuncia VxlanUDPPortNumerConfigurable como TRUE, un controlador de protocolo puede establecer EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber en un valor distinto de 0. El controlador de minipuerto debe usar este número de puerto para buscar coincidencias y generar fotogramas VXLAN después de realizar correctamente el OID y también anunciar el valor actualizado en sus funcionalidades. Si el controlador de protocolo pasa un valor de 0, el controlador de minipuerto continúa usando el número de puerto inicializado a partir de la palabra clave estandarizada.

EncapsulationProtocolParameters.VxlanParameters

Estructura que contiene VxlanUDPPortNumber.

EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber

Valor del puerto de destino de VXLAN. Este valor se establece en el valor asignado por IANA de 4789 de forma predeterminada. Si el controlador de minipuerto admite un número de puerto configurable tal como se anuncia en la estructura de NDIS_OFFLOAD , un controlador de protocolo puede emitir un OID de OID_TCP_OFFLOAD_PARAMETERS para habilitar NDIS_ENCAPSULATION_TYPE_VXLAN con un valor diferente en VxlanUDPPortNumber. El controlador de minipuerto debe usar VxlanUDPPortNumber para determinar los paquetes encapsulados de VXLAN para realizar descargas de recepción.

EncapsulationProtocolParameters.Value

Valor de puerto si EncapsulationTypes no está establecido en NDIS_ENCAPSULATION_TYPE_VXLAN.

_ENCAPSULATION_PROTOCOL_PARAMETERS

Nombre de tipo para EncapsulationProtocolParameters.

UdpSegmentation

Estructura que describe la configuración de descarga de la descarga de segmentación UDP (USO) del adaptador de miniporte.

UdpSegmentation.IPv4

Configuración de descarga de segmentación UDP IPv4 (USO) del adaptador de minipuerto. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_DISABLED	USO está deshabilitado.
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_ENABLED	USO está habilitado.

UdpSegmentation.IPv6

Configuración de descarga de segmentación UDP IPv6 (USO) del adaptador de minipuerto. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_DISABLED	USO está deshabilitado.
NDIS_OFFLOAD_PARAMETERS_UDP_SEG_ENABLED	USO está habilitado.

UdpRsc

Estructura que describe la configuración de descarga de descarga (URO) del segmento de recepción UDP del adaptador de miniporte.

UdpRsc.Enabled

Configuración URO del adaptador de minipuerto. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_NO_CHANGE 0	El controlador de minipuerto no debe cambiar la configuración actual.
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_DISABLED 1	URO está deshabilitado.
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_ENABLED 2	URO está habilitado.

Comentarios

En respuesta a una solicitud de conjunto de OID de OID_TCP_OFFLOAD_PARAMETERS , un controlador de minipuerto usa la configuración de la estructura NDIS_OFFLOAD_PARAMETERS para establecer la configuración actual del adaptador de minipuerto.

NDIS conserva la configuración solicitada en el Registro en las palabras clave estandarizadas de descarga. Cuando NDIS reinicia el adaptador de miniport, el controlador de minipuerto lee las palabras clave estandarizadas de descarga y las usa para establecer la configuración de descarga predeterminada de la NIC.

Para acceder a la configuración de descarga de suma de comprobación, use los siguientes miembros de la estructura NDIS_OFFLOAD_PARAMETERS :

IPv4Checksum

TCPIPv4Checksum

UDPIPv4Checksum

TCPIPv6Checksum

UDPIPv6Checksum

Los miembros anteriores pueden tener uno de los siguientes valores:

NDIS_OFFLOAD_PARAMETERS_NO_CHANGE
El controlador de minipuerto no debe cambiar la configuración actual.

NDIS_OFFLOAD_PARAMETERS_TX_RX_DISABLED
La característica que especifica el miembro está deshabilitada.

NDIS_OFFLOAD_PARAMETERS_TX_ENABLED_RX_DISABLED
La característica que especifica el miembro está habilitada para la transmisión y deshabilitada para la recepción.

NDIS_OFFLOAD_PARAMETERS_RX_ENABLED_TX_DISABLED
La característica que especifica el miembro está habilitada para la recepción y deshabilitada para la transmisión.

NDIS_OFFLOAD_PARAMETERS_TX_RX_ENABLED
La característica que especifica el miembro está habilitada para la transmisión y recepción.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, compatible con NDIS 6.0 y versiones posteriores.
Servidor mínimo compatible	Windows Server 2008
Encabezado	ntddndis.h (include Ndis.h)

Consulte también

NDIS_OBJECT_HEADER

OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES

OID_TCP_OFFLOAD_PARAMETERS

Compartir a través de

estructura NDIS_OFFLOAD_PARAMETERS (ntddndis.h)

Sintaxis

Miembros

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales