structure TCP_OFFLOAD_STATE_CONST (ndischimney.h)

Article
02/29/2024

[La fonctionnalité de déchargement de la cheminée TCP est déconseillée et ne doit pas être utilisée.]

La structure TCP_OFFLOAD_STATE_CONST contient les variables constantes d’un objet d’état de connexion TCP.

Syntaxe

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;

Membres

Header

Structure OFFLOAD_STATE_HEADER . NDIS définit le membre Length de Header sur la taille, en octets, de la structure TCP_OFFLOAD_STATE_CONST. Le membre RecognizedOptions de l’en-tête est réservé.

Flags

Masque de bits qui peut être défini sur zéro ou sur l’un des indicateurs suivants, combiné avec le bit OR :

TCP_FLAG_TIMESTAMP_ENABLED

La pile de l’hôte définit cet indicateur pour activer l’option d’horodatage TCP sur la connexion. (Pour plus d’informations sur l’option d’horodatage TCP, consultez RFC 1323.) Lorsque cette option est activée, la cible de déchargement doit placer un horodatage dans chaque segment TCP qu’elle envoie. La pile de l’hôte efface cet indicateur pour désactiver l’option d’horodatage TCP sur la connexion.

TCP_FLAG_SACK_ENABLED

La pile de l’hôte définit cet indicateur pour activer les accusés de réception sélectifs (SACK) sur la connexion. (Pour plus d’informations sur les SACK, consultez RFC 2018.) Lorsque cette option est activée, la cible de déchargement envoie et reçoit des blocs SACK sur la connexion TCP. La pile de l’hôte efface cet indicateur pour désactiver les SACK sur la connexion.

TCP_FLAG_WINDOW_SCALING_ENABLED

La pile de l’hôte définit cet indicateur pour que la cible de déchargement utilise des facteurs de mise à l’échelle (SndWindScale et RcvWindScale) pour calculer les fenêtres d’envoi et de réception pour la connexion. (Pour plus d’informations sur les facteurs d’échelle de fenêtre, consultez RFC 2883 et 3517.) La pile de l’hôte efface cet indicateur pour désactiver cette option.

RemotePort

Numéro de port de destination (voir RFC 793).

LocalPort

Numéro de port source (voir RFC 793).

SndWindScale

Facteur d’échelle de fenêtre d’envoi (voir RFC 1323).

RcvWindScale

Facteur d’échelle de fenêtre de réception (voir RFC 1323).

RemoteMss

Taille de segment maximale initiale (MSS) annoncée par le point de terminaison distant pendant la configuration de la connexion TCP. (Pour plus d’informations sur MSS, consultez RFC 2581.)

HashValue

Valeur de hachage 32 bits que la cible de déchargement utilise pour le traitement de mise à l’échelle côté réception (RSS) sur la connexion TCP si la cible de déchargement prend en charge RSS.

Remarques

La valeur de chaque variable de constante TCP ne change pas pendant la durée de vie d’une connexion TCP. Ni la pile hôte ni la cible de déchargement ne modifient les valeurs d’une variable constante TCP. Lorsque la pile de l’hôte met fin au déchargement de l’objet d’état de connexion TCP, ce qui entraîne l’appel de NDIS de la cible de déchargement Fonction MiniportTerminateOffload , la cible de déchargement ne retourne pas la valeur des variables de constante TCP déchargées à la pile hôte.

Lorsqu’elle est passée à une cible de déchargement, une structure TCP_OFFLOAD_STATE_CONST est associée à une NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure, qui contient un en-tête mis en forme en tant que structure de NDIS_OBJECT_HEADER . Dans ce cas, le membre Revision de la structure NDIS_OBJECT_HEADER spécifie le numéro de révision de la structure TCP_OFFLOAD_STATE_CONST.