estructura TCP_OFFLOAD_STATE_CONST (ndischimney.h)

Artículo
02/07/2025

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

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 RFCs 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 la 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 configuración de la conexión TCP. (Para obtener más información sobre MSS, consulte RFC 2581).

HashValue

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

Observaciones

El valor de cada variable constante TCP no cambia durante la vida de una conexión TCP. Ni la pila del host ni el destino de descarga cambian los valores de una variable constante TCP. Cuando la pila de hosts finaliza la descarga del objeto de estado de conexión TCP haciendo que NDIS llame al destino de descarga. 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 una NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura, que contiene un encabezado con formato de estructura NDIS_OBJECT_HEADER. El miembro Revision de la estructura NDIS_OBJECT_HEADER, en este caso, especifica el número de revisión de la estructura TCP_OFFLOAD_STATE_CONST.