estrutura TCP_OFFLOAD_STATE_CONST (ndischimney.h)

Artigo
08/07/2023

[O recurso de descarregamento de chaminé TCP foi preterido e não deve ser usado.]

A estrutura TCP_OFFLOAD_STATE_CONST contém as variáveis constantes de um objeto de estado de conexão TCP.

Sintaxe

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;

Membros

Header

Uma estrutura OFFLOAD_STATE_HEADER . O NDIS define o membro Length de Header como o tamanho, em bytes, da estrutura TCP_OFFLOAD_STATE_CONST. O membro RecognizedOptions de Header é reservado.

Flags

Uma máscara de bits que pode ser definida como zero ou qualquer um dos seguintes sinalizadores, combinado com OR bit a bit:

TCP_FLAG_TIMESTAMP_ENABLED

A pilha de host define esse sinalizador para habilitar a opção de carimbo de data/hora TCP na conexão. (Para obter mais informações sobre a opção de carimbo de data/hora TCP, consulte RFC 1323.) Quando essa opção está habilitada, o destino de descarregamento deve colocar um carimbo de data/hora em cada segmento TCP que ele envia. A pilha de host limpa esse sinalizador para desabilitar a opção de carimbo de data/hora TCP na conexão.

TCP_FLAG_SACK_ENABLED

A pilha de host define esse sinalizador para habilitar SACKs (confirmações seletivas) na conexão. (Para obter mais informações sobre os SACKs, consulte RFC 2018.) Quando essa opção está habilitada, o destino de descarregamento envia e recebe blocos SACK sobre a conexão TCP. A pilha de host limpa esse sinalizador para desabilitar SACKs na conexão.

TCP_FLAG_WINDOW_SCALING_ENABLED

A pilha de host define esse sinalizador para fazer com que o destino de descarregamento use fatores de escala (SndWindScale e RcvWindScale) para calcular o envio e o recebimento de janelas para a conexão. (Para obter mais informações sobre fatores de escala de janela, consulte RFCs 2883 e 3517.) A pilha de host limpa esse sinalizador para desabilitar essa opção.

RemotePort

O número da porta de destino (consulte RFC 793).

LocalPort

O número da porta de origem (consulte RFC 793).

SndWindScale

O fator de escala da janela de envio (consulte RFC 1323).

RcvWindScale

O fator de escala da janela de recebimento (consulte RFC 1323).

RemoteMss

O MSS (tamanho máximo do segmento) inicial anunciado pelo ponto de extremidade remoto durante a instalação da conexão TCP. (Para obter mais informações sobre o MSS, consulte RFC 2581.)

HashValue

Um valor de hash de 32 bits que o destino de descarregamento usa para processamento de RSS (dimensionamento lateral de recebimento) na conexão TCP se o destino de descarregamento der suporte ao RSS.

Comentários

O valor de cada variável de constante TCP não é alterado durante a vida útil de uma conexão TCP. Nem a pilha de host nem o destino de descarregamento alteram os valores de uma variável de constante TCP. Quando a pilha de host termina o descarregamento do objeto de estado de conexão TCP fazendo com que o NDIS chame o destino de descarregamento Função MiniportTerminateOffload , o destino de descarregamento não retorna o valor das variáveis constantes TCP descarregadas para a pilha de host.

Quando passada para um destino de descarregamento, uma estrutura de TCP_OFFLOAD_STATE_CONST é associada a um NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estrutura, que contém um cabeçalho formatado como uma estrutura NDIS_OBJECT_HEADER . O membro Revision da estrutura NDIS_OBJECT_HEADER, nesse caso, especifica o número de revisão da estrutura TCP_OFFLOAD_STATE_CONST.