estructura NDIS_OFFLOAD_PARAMETERS (ntddndis.h)

Artículo
02/07/2025

La estructura NDIS_OFFLOAD_PARAMETERS especifica las opciones 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 NDIS_OFFLOAD_PARAMETERS. Establezca el miembro type de de la estructura que encabezado especifica para NDIS_OBJECT_TYPE_DEFAULT.

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

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_REVISION_6 6	Admite el miembro de udpRsc de para NDIS 6.89. Establezca el miembro tamaño de en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_6.
NDIS_OFFLOAD_PARAMETERS_REVISION_5 5	Admite la de UdpSegmentation para IPv4 e IPv6 para NDIS 6.83. Establezca el miembro tamaño de en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_5.
NDIS_OFFLOAD_PARAMETERS_REVISION_4 4	Admite el encapsulationProtocolParameters de y sus VxlanParameters anidados para NDIS 6.50. Establezca el miembro tamaño de en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_4.
NDIS_OFFLOAD_PARAMETERS_REVISION_3 3	Admite el RscIPv4, RscIPv6, EncapsulatedPacketTaskOffload, y Miembros EncapsulationTypes para NDIS 6.30. Establezca el miembro Size en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_3.
NDIS_OFFLOAD_PARAMETERS_REVISION_2 2	Admite el IPsecV2 , IPsecV2IPv4, Reserved1y miembros reserved2 para NDIS 6.1. Establezca el miembro tamaño de en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_2.
NDIS_OFFLOAD_PARAMETERS_REVISION_1 1	Versión original de NDIS 6.0. Establezca el miembro tamaño de en NDIS_SIZEOF_OFFLOAD_PARAMETERS_REVISION_1.

IPv4Checksum

Configuración de suma de comprobación IPv4 del adaptador de miniport. Para obtener más información, vea la siguiente sección Comentarios.

TCPIPv4Checksum

Configuración de suma de comprobación IPv4 del adaptador de miniport para paquetes TCP. Para obtener más información, vea la siguiente sección Comentarios.

UDPIPv4Checksum

Configuración de suma de comprobación IPv4 del adaptador de miniport para paquetes UDP. Para obtener más información, vea la siguiente sección Comentarios.

TCPIPv6Checksum

Configuración de suma de comprobación IPv6 del adaptador de miniport para paquetes TCP. Para obtener más información, vea la siguiente sección Comentarios.

UDPIPv6Checksum

Configuración de suma de comprobación IPv6 del adaptador de miniport para paquetes UDP. Para obtener más información, vea la siguiente sección Comentarios.

LsoV1

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

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

IPsecV1

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

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador miniport 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 Encabezado de autenticación de descarga de IPsec (AH) debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV1_ESP_ENABLED	La característica Carga de seguridad (ESP) de descarga 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

El valor 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 miniport 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

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

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador miniport 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 miniport. Esta configuración se especifica como uno de los siguientes valores:

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

TcpConnectionIPv6

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

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador miniport 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 del 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 admite 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 miniport 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 de descarga de encabezado de autenticación (AH) versión 2 debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED	La característica carga de IPsec versión 2 encapsulando la carga de seguridad (ESP) debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED	Las características IPsec offload 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 compatible con IPv4 y no admite IPv6. Si el controlador de miniporte 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 miniport 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 de descarga de encabezado de autenticación (AH) versión 2 debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_ESP_ENABLED	La característica carga de IPsec versión 2 encapsulando la carga de seguridad (ESP) debe estar habilitada para la transmisión y recepción.
NDIS_OFFLOAD_PARAMETERS_IPSECV2_AH_AND_ESP_ENABLED	Las características IPsec offload 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 y 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 tareas 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 el EncapsulatedPacketTaskOffload se establece 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 miniporte anunciado VxlanUDPPortNumerConfigurable como TRUE, un controlador de protocolo puede establecer EncapsulationProtocolParameters.VxlanParameters.VxlanUdPPortNumber en un valor distinto de 0. El controlador de miniporte debe usar este número de puerto para buscar coincidencias y generar fotogramas VXLAN después de realizar correctamente el OID y anunciar también el valor actualizado en sus funcionalidades. Si el controlador de protocolo pasa un valor de 0, el controlador de miniporte continúa usando el número de puerto inicializado a partir de la palabra clave estandarizada.

EncapsulationProtocolParameters.VxlanParameters

Estructura que contiene el VxlanUDPPortNumber.

EncapsulationProtocolParameters.VxlanParameters.VxlanUDPPortNumber

Valor del puerto de destino VXLAN. Este valor se establece en el valor asignado a IANA de 4789 de forma predeterminada. Si el controlador de miniporte 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 miniport 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 segmentación UDP (USO) del adaptador de miniporte.

UdpSegmentation.IPv4

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

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador miniport 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 miniport. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_NO_CHANGE	El controlador miniport 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 miniport. Esta configuración debe ser uno de los siguientes valores:

Valor	Significado
NDIS_OFFLOAD_PARAMETERS_UDP_RSC_NO_CHANGE 0	El controlador miniport 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.

Observaciones

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

NDIS conserva la configuración solicitada en el Registro en las palabras clave estandarizadas de descarga. Cuando NDIS reinicia el adaptador de minipuerto, el controlador de miniporta lee las palabras clave estandarizadas de descarga 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 de 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 miniport 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 recibir y deshabilitar 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	Valor
cliente mínimo admitido	Windows Vista,Compatible con NDIS 6.0 y versiones posteriores.
servidor mínimo admitido	Windows Server 2008
encabezado de	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