NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS structure (ndischimney.h)

Article
03/01/2024

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

La structure NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS fournit des informations de déchargement de cheminée TCP dans le OID_TCP_CONNECTION_OFFLOAD_PARAMETERS OID.

Syntaxe

typedef struct _NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS {
  NDIS_OBJECT_HEADER         Header;
  NDIS_OFFLOAD_ENCAPSULATION Encapsulation;
  ULONG                      TicksPerSecond;
  UCHAR                      TcpAckFrequency;
  UCHAR                      TcpDelayedAckTicks;
  UCHAR                      TcpMaximumRetransmissions;
  UCHAR                      TcpDoubtReachabilityRetransmissions;
  ULONG                      TcpSwsPreventionTicks;
  ULONG                      TcpDuplicateAckThreshold;
  ULONG                      TcpPushTicks;
  ULONG                      NceStaleTicks;
  ULONG                      CongestionAlgorithm;
} NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS, *PNDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS. Définissez le membre Type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revisionsur NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS_ 1 et le membre Size sur sizeof(NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS).

Encapsulation

An NDIS_OFFLOAD_ENCAPSULATION structure qui contient les paramètres d’encapsulation pour le déchargement de cheminée TCP.

TicksPerSecond

Valeur ULONG que la pile de pilotes TCP/IP définit pour spécifier le nombre de cycles de l’horloge de l’hôte égal à une seconde. La valeur par défaut est 1000 (autrement dit, 1 graduation = 1 milliseconde). Une cible de déchargement doit prendre en charge ce membre.

TcpAckFrequency

Valeur UCHAR que la pile de pilotes TCP/IP définit pour spécifier le nombre maximal de segments que la cible de déchargement peut recevoir avant que la cible envoie un ACK. Une cible de déchargement doit prendre en charge ce membre.

TcpDelayedAckTicks

Valeur UCHAR que la pile de pilotes TCP/IP définit pour spécifier le nombre de cycles, à partir de la réception d’un segment, que la cible de déchargement doit attendre d’autres segments de réception avant que la cible envoie un ACK. Une cible de déchargement utilise cette valeur pour initialiser son minuteur ACK retardé. Une cible de déchargement doit prendre en charge ce membre.

TcpMaximumRetransmissions

Valeur UCHAR que la pile de pilotes TCP/IP définit pour spécifier le nombre maximal de fois que la cible de déchargement doit retransmettre un segment sur une connexion TCP. Lorsque le compteur de retransmettre pour une connexion TCP dépasse cette limite, la cible de déchargement peut appeler le Fonction NdisTcpOffloadEventHandler avec un paramètre EventType de TcpIndicateRetrieve pour demander que la pile de pilotes TCP/IP termine le déchargement de la connexion. Une cible de déchargement doit prendre en charge ce membre.

TcpDoubtReachabilityRetransmissions

Valeur UCHAR que la pile de pilotes TCP/IP définit pour spécifier le nombre maximal de fois que la cible de déchargement doit retransmettre un segment avant que la cible n’indique à la pile de pilotes TCP/IP que l’accessibilité d’un voisin est en doute. Pour plus d’informations sur cette indication, consultez NdisMOffloadEventIndicate. Une cible de déchargement doit prendre en charge ce membre.

TcpSwsPreventionTicks

Valeur ULONG que la pile de pilotes TCP/IP définit pour spécifier le nombre de cycles pour les minuteurs d’envoi et de réception du syndrome de fenêtre idiote (SWS) de la cible de déchargement. Lorsque le minuteur d’envoi SWS expire, la cible de déchargement envoie un segment partiel. Lorsque le minuteur de réception SWS expire, la cible de déchargement envoie une mise à jour de fenêtre. Une cible de déchargement doit prendre en charge ce membre.

TcpDuplicateAckThreshold

Valeur ULONG que la pile de pilotes TCP/IP définit pour spécifier le nombre d’accusés de réception en double que la cible de déchargement doit recevoir avant que la cible effectue une retransmission rapide. Une cible de déchargement doit prendre en charge ce membre.

TcpPushTicks

Valeur ULONG que la pile de pilotes TCP/IP définit pour spécifier le nombre de cycles qu’une cible de déchargement doit attendre avant que la cible termine une mémoire tampon de réception pré-publiée. Cet intervalle commence immédiatement après que la cible de déchargement a placé le premier octet dans la mémoire tampon de réception pré-publiée. Une cible de déchargement utilise cette valeur pour initialiser son minuteur push. Une cible de déchargement doit prendre en charge ce membre.

NceStaleTicks

Valeur ULONG que la pile de pilotes TCP/IP définit pour indiquer le nombre de cycles d’inactivité qui rendent un objet d’état voisin obsolète. Une cible de déchargement doit prendre en charge ce membre.

CongestionAlgorithm

Réservé pour un usage futur.

Si vous êtes un fournisseur de matériel indépendant (IHV) et que vous souhaitez implémenter des algorithmes de contrôle de congestion non par défaut, par exemple TCP composé, contactez Microsoft à l’adresse Triage de déchargement TCP externe.

Remarques

Dans NDIS 6.0 et versions ultérieures, la structure NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS spécifie les paramètres actuels ou demandés qu’un adaptateur miniport fournit pour le déchargement de la cheminée TCP.

Pour spécifier différents paramètres de déchargement, les pilotes NDIS et overlying fournissent une structure NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS lorsqu’ils définissent le OID_TCP_CONNECTION_OFFLOAD_PARAMETERS OID.

Pour obtenir les paramètres actuels de différents paramètres de déchargement, les pilotes NDIS et overlying interrogent OID_TCP_CONNECTION_OFFLOAD_PARAMETERS. Le pilote miniport retourne les paramètres actuels dans la structure NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS.

Le membre Encapsulation de NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS définit les paramètres d’encapsulation de déchargement de cheminée TCP pour l’adaptateur miniport. Pour plus d’informations, consultez la documentation sur le déchargement de cheminée TCP NDIS 6.0.