NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS Struktur (ndischimney.h)

Artikel
02/29/2024

[Das TCP-Chimney-Auslagerungsfeature ist veraltet und sollte nicht verwendet werden.]

Die NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS-Struktur stellt TCP-Schornsteinabladungsinformationen im OID_TCP_CONNECTION_OFFLOAD_PARAMETERS OID.

Syntax

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;

Member

Header

Die NDIS_OBJECT_HEADER-Struktur für die NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS-Struktur. Legen Sie das Type-Element der Struktur, die Header angibt, auf NDIS_OBJECT_TYPE_DEFAULT, das Revisionselement auf NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS_ 1 und das Size-Element auf fest sizeof(NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS).

Encapsulation

Eine NDIS_OFFLOAD_ENCAPSULATION Struktur, die Kapselungseinstellungen für die TCP-Schornsteinabladung enthält.

TicksPerSecond

Ein ULONG-Wert, den der TCP/IP-Treiberstapel festlegt, um anzugeben, wie viele Ticks der Uhr des Hosts einer Sekunde entsprechen. Der Standardwert ist 1000 (d. h. 1 Tick = 1 Millisekunde). Dieses Element muss von einem Auslagerungsziel unterstützt werden.

TcpAckFrequency

Ein UCHAR-Wert, den der TCP/IP-Treiberstapel festlegt, um die maximale Anzahl von Segmenten anzugeben, die das Auslagerungsziel empfangen kann, bevor das Ziel einen ACK sendet. Dieses Element muss von einem Auslagerungsziel unterstützt werden.

TcpDelayedAckTicks

Ein UCHAR-Wert, den der TCP/IP-Treiberstapel festlegt, um anzugeben, wie viele Ticks das Auslagerungsziel ab dem Empfang eines Segments auf zusätzliche Empfangssegmente warten soll, bevor das Ziel einen ACK sendet. Ein Auslagerungsziel verwendet diesen Wert, um seinen delayed-ACK-Timer zu initialisieren. Dieses Element muss von einem Auslagerungsziel unterstützt werden.

TcpMaximumRetransmissions

Ein UCHAR-Wert, den der TCP/IP-Treiberstapel festlegt, um die maximale Häufigkeit anzugeben, mit der das Auslagerungsziel ein Segment für eine TCP-Verbindung erneut übertragen soll. Wenn der Retransmit-Zähler für eine TCP-Verbindung diesen Grenzwert überschreitet, kann das Auslagerungsziel die NdisTcpOffloadEventHandler-Funktion mit einem EventType-Parameter von TcpIndicateRetrieve , um anzufordern, dass der TCP/IP-Treiberstapel die Auslagerung der Verbindung beendet. Dieses Element muss von einem Auslagerungsziel unterstützt werden.

TcpDoubtReachabilityRetransmissions

Ein UCHAR-Wert, den der TCP/IP-Treiberstapel festlegt, um anzugeben, wie oft das Auslagerungsziel ein Segment erneut übertragen soll, bevor das Ziel an den TCP/IP-Treiberstapel angibt, dass die Erreichbarkeit eines Nachbarn zweifelhaft ist. Weitere Informationen zu diesem Hinweis finden Sie unter NdisMOffloadEventIndicate. Dieses Element sollte von einem Auslagerungsziel unterstützt werden.

TcpSwsPreventionTicks

Ein ULONG-Wert, den der TCP/IP-Treiberstapel festlegt, um die Anzahl der Ticks für das Silly Window-Syndrom (SWS) des Auslagerungsziels (Silly Window Syndrome) für Senden und Empfangen von Timern anzugeben. Wenn für den SWS-Sendetimer ein Timerüberschreitung erfolgt, sendet das Auslagerungsziel ein Teilsegment. Wenn für den SWS-Empfang timer ein Timerüberschreitung erfolgt, sendet das Auslagerungsziel ein Fensterupdate. Dieses Element sollte von einem Auslagerungsziel unterstützt werden.

TcpDuplicateAckThreshold

Ein ULONG-Wert, den der TCP/IP-Treiberstapel festlegt, um die Anzahl der doppelten Bestätigungen anzugeben, die das Auslagerungsziel empfangen muss, bevor das Ziel eine schnelle erneute Übertragung durchführt. Dieses Element muss von einem Auslagerungsziel unterstützt werden.

TcpPushTicks

Ein ULONG-Wert, den der TCP/IP-Treiberstapel festlegt, um die Anzahl der Ticks anzugeben, die ein Auslagerungsziel warten muss, bevor das Ziel einen vorab gebuchten Empfangspuffer abgeschlossen hat. Dieses Intervall beginnt unmittelbar, nachdem das Auslagerungsziel das erste Byte im vorab gebuchten Empfangspuffer platziert hat. Ein Auslagerungsziel verwendet diesen Wert, um seinen Pushtimer zu initialisieren. Dieses Element muss von einem Auslagerungsziel unterstützt werden.

NceStaleTicks

Ein ULONG-Wert, den der TCP/IP-Treiberstapel festlegt, um die Anzahl der Ticks der Inaktivität anzugeben, die ein benachbartes Zustandsobjekt veraltet machen. Dieses Element muss von einem Auslagerungsziel unterstützt werden.

CongestionAlgorithm

Für die zukünftige Verwendung reserviert.

Wenn Sie ein unabhängiger Hardwareanbieter (Independent Hardware Vendor, IHV) sind und Algorithmen zur Kontrolle der Staukontrolle ohne Standard implementieren möchten, z. B. Zusammengesetztes TCP, wenden Sie sich an Microsoft unter External TCP Offload Triage.

Hinweise

In NDIS 6.0 und höheren Versionen gibt die NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS-Struktur die aktuellen oder angeforderten Parameter an, die ein Miniportadapter für die TCP-Schornsteinabladung bereitstellt.

Um verschiedene Auslagerungsparametereinstellungen anzugeben, stellen NDIS und überlagernde Treiber eine NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS-Struktur bereit, wenn sie die OID_TCP_CONNECTION_OFFLOAD_PARAMETERS OID.

Um die aktuellen Einstellungen verschiedener Auslagerungsparameter abzurufen, fragen NDIS und überlagernde Treiber OID_TCP_CONNECTION_OFFLOAD_PARAMETERS ab. Der Miniporttreiber gibt die aktuellen Einstellungen in der NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS-Struktur zurück.

Das Encapsulationsmitglied von NDIS_TCP_CONNECTION_OFFLOAD_PARAMETERS definiert die TCP-Schornstein-Entkapselungseinstellungen für den Miniportadapter. Weitere Informationen finden Sie in der NDIS 6.0 TCP-Kaminabladungsdokumentation.