estructura TCP_OFFLOAD_STATE_CONST (ndischimney.h)

Artículo
02/29/2024

[La característica de descarga de chimenea TCP está en desuso y no se debe usar.]

La estructura TCP_OFFLOAD_STATE_CONST contiene las variables constantes de un objeto de estado de conexión TCP.

Sintaxis

typedef struct _TCP_OFFLOAD_STATE_CONST {
  OFFLOAD_STATE_HEADER Header;
  USHORT               Flags;
  USHORT               RemotePort;
  USHORT               LocalPort;
  UCHAR                SndWindScale : 4;
  UCHAR                RcvWindScale : 4;
  USHORT               RemoteMss;
  ULONG                HashValue;
} TCP_OFFLOAD_STATE_CONST, *PTCP_OFFLOAD_STATE_CONST;

Miembros

Header

Estructura OFFLOAD_STATE_HEADER . NDIS establece el miembro Length de Header en el tamaño, en bytes, de la estructura TCP_OFFLOAD_STATE_CONST. El miembro RecognizeOptions de Header está reservado.

Flags

Máscara de bits que se puede establecer en cero o en cualquiera de las marcas siguientes, combinadas con OR bit a bit:

TCP_FLAG_TIMESTAMP_ENABLED

La pila de hosts establece esta marca para habilitar la opción de marca de tiempo TCP en la conexión. (Para obtener más información sobre la opción de marca de tiempo TCP, consulte RFC 1323). Cuando esta opción está habilitada, el destino de descarga debe colocar una marca de tiempo en cada segmento TCP que envíe. La pila de hosts borra esta marca para deshabilitar la opción de marca de tiempo TCP en la conexión.

TCP_FLAG_SACK_ENABLED

La pila de hosts establece esta marca para habilitar confirmaciones selectivas (SACK) en la conexión. (Para obtener más información sobre los SACK, consulte RFC 2018). Cuando esta opción está habilitada, el destino de descarga envía y recibe bloques SACK a través de la conexión TCP. La pila de hosts borra esta marca para deshabilitar SACK en la conexión.

TCP_FLAG_WINDOW_SCALING_ENABLED

La pila de hosts establece esta marca para que el destino de descarga use factores de escala (SndWindScale y RcvWindScale) para calcular las ventanas de envío y recepción de la conexión. (Para obtener más información sobre los factores de escala de ventanas, consulte RFC 2883 y 3517). La pila de hosts borra esta marca para deshabilitar esta opción.

RemotePort

Número de puerto de destino (consulte RFC 793).

LocalPort

Número de puerto de origen (consulte RFC 793).

SndWindScale

Factor de escala de ventana de envío (consulte RFC 1323).

RcvWindScale

Factor de escala de ventana de recepción (consulte RFC 1323).

RemoteMss

Tamaño de segmento máximo inicial (MSS) anunciado por el punto de conexión remoto durante la instalación de la conexión TCP. (Para obtener más información sobre MSS, consulte RFC 2581).

HashValue

Valor hash de 32 bits que el destino de descarga usa para el procesamiento de escalado lateral de recepción (RSS) en la conexión TCP si el destino de descarga admite RSS.

Comentarios

El valor de cada variable constante TCP no cambia durante la vida de una conexión TCP. Ni la pila de hosts ni el destino de descarga cambian los valores de una variable constante TCP. Cuando la pila del host finaliza la descarga del objeto de estado de conexión TCP, lo que provoca que NDIS llame al destino de descarga. La función MiniportTerminateOffload , el destino de descarga no devuelve el valor de las variables constantes TCP descargadas a la pila de hosts.

Cuando se pasa a un destino de descarga, se asocia una estructura de TCP_OFFLOAD_STATE_CONST a un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura, que contiene un encabezado con formato de estructura NDIS_OBJECT_HEADER . En este caso, el miembro Revision de la estructura NDIS_OBJECT_HEADER especifica el número de revisión de la estructura TCP_OFFLOAD_STATE_CONST.