struttura TCP_OFFLOAD_STATE_CONST (ndischimney.h)

Articolo
08/07/2023

[La funzionalità di offload del camino TCP è deprecata e non deve essere usata.]

La struttura TCP_OFFLOAD_STATE_CONST contiene le variabili costanti di un oggetto stato di connessione TCP.

Sintassi

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;

Members

Header

Struttura OFFLOAD_STATE_HEADER . NDIS imposta il membro Length di Header sulle dimensioni, in byte, della struttura TCP_OFFLOAD_STATE_CONST. Il membro RecognizedOptions di Header è riservato.

Flags

Maschera di bit che può essere impostata su zero o su uno qualsiasi dei flag seguenti, combinati con OR bit per bit:

TCP_FLAG_TIMESTAMP_ENABLED

Lo stack host imposta questo flag per abilitare l'opzione timestamp TCP nella connessione. Per altre informazioni sull'opzione timestamp TCP, vedere RFC 1323. Quando questa opzione è abilitata, la destinazione di offload deve inserire un timestamp in ogni segmento TCP inviato. Lo stack host cancella questo flag per disabilitare l'opzione timestamp TCP nella connessione.

TCP_FLAG_SACK_ENABLED

Lo stack host imposta questo flag per abilitare i riconoscimenti selettivi (SACK) nella connessione. Per altre informazioni sui SACK, vedere RFC 2018. Quando questa opzione è abilitata, la destinazione di offload invia e riceve blocchi SACK sulla connessione TCP. Lo stack host cancella questo flag per disabilitare i SACK nella connessione.

TCP_FLAG_WINDOW_SCALING_ENABLED

Lo stack host imposta questo flag per fare in modo che la destinazione di offload usi fattori di scala (SndWindScale e RcvWindScale) per calcolare le finestre di invio e ricezione per la connessione. Per altre informazioni sui fattori di scala delle finestre, vedere RFCs 2883 e 3517. Lo stack host cancella questo flag per disabilitare questa opzione.

RemotePort

Numero di porta di destinazione (vedere RFC 793).

LocalPort

Numero di porta di origine (vedere RFC 793).

SndWindScale

Fattore di scala della finestra di invio (vedere RFC 1323).

RcvWindScale

Fattore di scala della finestra di ricezione (vedere RFC 1323).

RemoteMss

Dimensioni massime iniziali del segmento (MSS) annunciate dall'endpoint remoto durante la configurazione della connessione TCP. Per altre informazioni su MSS, vedere RFC 2581.

HashValue

Valore hash a 32 bit usato dalla destinazione di offload per l'elaborazione RSS (Side Scaling) sulla connessione TCP se la destinazione di offload supporta RSS.

Commenti

Il valore di ogni variabile costante TCP non cambia durante la durata di una connessione TCP. Né lo stack host né la destinazione di offload modificano i valori di una variabile costante TCP. Quando lo stack host termina l'offload dell'oggetto stato della connessione TCP causando la chiamata di NDIS alla destinazione di offload La funzione MiniportTerminateOffload , la destinazione di offload non restituisce il valore delle variabili costanti TCP offloaded allo stack host.

Quando viene passata a una destinazione di offload, una struttura TCP_OFFLOAD_STATE_CONST è associata a un oggetto NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struttura, che contiene un'intestazione formattata come struttura NDIS_OBJECT_HEADER . Il membro Revision della struttura NDIS_OBJECT_HEADER, in questo caso, specifica il numero di revisione della struttura TCP_OFFLOAD_STATE_CONST.