TCP_OFFLOAD_STATE_DELEGATED-Struktur (ndischimney.h)
[Das TCP-Schornsteinauslagerungsfeature ist veraltet und sollte nicht verwendet werden.]
Die TCP_OFFLOAD_STATE_DELEGATED-Struktur enthält die delegierten Variablen eines TCP-Verbindungszustandsobjekts.
Syntax
typedef struct _TCP_OFFLOAD_STATE_DELEGATED {
OFFLOAD_STATE_HEADER Header;
TCP_OFFLOAD_CONNECTION_STATE State;
USHORT Flags;
ULONG RcvNxt;
ULONG RcvWnd;
ULONG SndUna;
ULONG SndNxt;
ULONG SndMax;
ULONG SndWnd;
ULONG MaxSndWnd;
ULONG SendWL1;
ULONG CWnd;
ULONG SsThresh;
USHORT SRtt;
USHORT RttVar;
ULONG TsRecent;
ULONG TsRecentAge;
ULONG TsTime;
ULONG TotalRT;
UCHAR DupAckCount;
UCHAR SndWndProbeCount;
struct {
UCHAR ProbeCount;
ULONG TimeoutDelta;
} KeepAlive;
struct {
UCHAR Count;
ULONG TimeoutDelta;
} Retransmit;
union {
struct {
PNET_BUFFER_LIST SendDataHead;
PNET_BUFFER_LIST SendDataTail;
};
ULONG SendBacklogSize;
};
union {
PNET_BUFFER_LIST BufferedData;
ULONG ReceiveBacklogSize;
};
ULONG DWnd;
} TCP_OFFLOAD_STATE_DELEGATED, *PTCP_OFFLOAD_STATE_DELEGATED;
Member
Header
Eine OFFLOAD_STATE_HEADER-Struktur . NDIS legt den Length-Member von Header auf die Größe der TCP_OFFLOAD_STATE_DELEGATED-Struktur in Bytes fest. Das RecognizedOptions-Element von Header ist reserviert.
State
Der aktuelle Zustand der TCP-Verbindung (siehe RFC 793) als einer der folgenden TCP_OFFLOAD_CONNECTION_STATE Werte:
TcpConnectionClosed
Kein Verbindungszustand.
TcpConnectionListen
Warten auf eine Verbindungsanforderung von einem beliebigen Remote-TCP und -Port.
TcpConnectionSynSent
Warten auf eine übereinstimmende Verbindungsanforderung, nachdem eine Verbindungsanforderung gesendet wurde.
TcpConnectionSynRcvd
Warten auf eine Bestätigung der Verbindungsanforderung, nachdem eine Verbindungsanforderung empfangen und gesendet wurde.
TcpConnectionEstablished
Eine offene Verbindung: Empfangene Daten können an den Benutzer übermittelt werden. Der normale Zustand für die Datenübertragungsphase der Verbindung
TcpConnectionFinWait1
Warten auf eine Verbindungsbeendigungsanforderung vom Remote-TCP oder auf eine Bestätigung der zuvor gesendeten Verbindungsabschlussanforderung.
TcpConnectionFinWait2
Warten auf eine Verbindungsabschlussanforderung vom Remote-TCP.
TcpConnectionCloseWait
Warten auf eine Verbindungsbeendigungsanforderung vom lokalen Benutzer.
TcpConnectionClosing
Warten auf eine Bestätigung der Verbindungsbeendigung vom Remote-TCP.
TcpConnectionLastAck
Warten auf eine Bestätigung der Verbindungsabschlussanforderung, die zuvor an das Remote-TCP gesendet wurde, einschließlich einer Bestätigung der Verbindungsbeendigungsanforderung.
TcpConnectionTimeWait
Warten Sie auf genügend Zeit, um sicherzustellen, dass das Remote-TCP die Bestätigung seiner Verbindungsabschlussanforderung erhalten hat.
Beachten Sie, dass der Hoststapel eine TCP-Verbindung auslagern kann, wenn sich die Verbindung in einem beliebigen Zustand mit Ausnahme von TcpConnectionClosed, TcpConnectionListen, TcpConnectionSynRcvd befindet.
TcpConnectionSynSent oder TcpConnectionTimeWait-Zustand . Der Hoststapel kann eine TCP-Verbindung unabhängig vom Verbindungsstatus abfragen, aktualisieren, ungültig erklären oder beenden.
Flags
Ist für das System reserviert.
RcvNxt
Die Sequenznummer für das nächste Empfangssegment (siehe RCV. WEITER in RFC 793).
RcvWnd
Die Größe des Empfangsfensters in Bytes (siehe RCV. WND in RFC 793).
SndUna
Die Sequenznummer für das erste Byte nicht bestätigter Daten (siehe SND. UNA in RFC 793). Weitere Informationen finden Sie unter Senden von Daten, die daten enthalten, die erneut ausgegeben werden sollen.
SndNxt
Die Sequenznummer für das nächste Byte, das an die Verbindung gesendet werden soll (siehe SND. NXT in RFC 793). Weitere Informationen finden Sie unter Senden von Daten, die daten enthalten, die erneut ausgegeben werden sollen.
SndMax
Die maximale Sequenznummer, die für die Verbindung gesendet wurde. Weitere Informationen finden Sie unter Senden von Daten, die daten enthalten, die erneut ausgegeben werden sollen.
SndWnd
Die Größe des Sendefensters in Bytes (siehe SND. WND in RFC 793).
MaxSndWnd
Die maximale Größe des Sendefensters in Bytes (siehe RFC 813).
SendWL1
Die Segmentsequenznummer, die für die letzte Fensteraktualisierung verwendet wurde (siehe SND. WL1 in RFC 793).
CWnd
Die Größe des Überlastungsfensters in Bytes (siehe cwnd in RFC 2581).
SsThresh
Der Schwellenwert für langsamen Start in Bytes (siehe ssthresh in RFC 2581).
SRtt
Die geglättete Roundtripzeit in Takttakten (siehe SRTT in RFCs 793 und 2988). Wird pro Verbindung verwaltet, da der Pfad, der Host und manchmal das Anwendungsverhalten berücksichtigt werden.
RttVar
Die Variation der Roundtripzeit in Takttakten (siehe RTTVAR in RFC 2988).
TsRecent
Der Zeitstempelwert, der im nächsten ACK gesendet werden soll (siehe TS. Zuletzt in RFC 1323)
TsRecentAge
Die Zeitdauer in Takttakten, seit der letzte Zeitstempel empfangen wurde (siehe RFC 1323).
TsTime
Der aktuelle Wert des angepassten Zeitstempels.
TotalRT
Die Gesamtzeit in Takttakten, die für die erneute Übertragung des aktuellen TCP-Segments aufgewendet wurde.
DupAckCount
Die Anzahl der ACKs, die für dieselbe Sequenznummer akzeptiert wurden (siehe RFC 1323).
SndWndProbeCount
Die aktuelle Sendefenster-Testrunde. Eine Beschreibung der Testrunde des Sendefensters finden Sie unter Persist Timer.
KeepAlive
Bei diesem Member handelt es sich um eine Union, die aus den folgenden Membern besteht:
KeepAlive.ProbeCount
Die Anzahl der gesendeten Keepalive-Tests, die keine Antwort erhalten haben (siehe RFC 1122).
KeepAlive.TimeoutDelta
Die verbleibende Zeit in Takten bis zum nächsten keepalive Timeout (siehe RFC 1122). Beachten Sie, dass der Wert -1 unmittelbar nach dem Ausladen der TCP-Verbindung angibt, dass der Keepalive-Timer nicht ausgeführt wurde, als die Verbindung ausgeladen wurde. Wenn der keepalive Timer des Auslagerungsziels nicht ausgeführt wird, sollte das Auslagerungsziel -1 in diesem Member zurückgeben, wenn es auf einen Aufruf der MiniportQueryOffload-Funktion oder der MiniportTerminateOffload-Funktion reagiert.
Retransmit
Bei diesem Member handelt es sich um eine Union, die aus den folgenden Membern besteht:
Retransmit.Count
Die Anzahl der gesendeten Neuübertragungen (siehe RFC 2581).
Retransmit.TimeoutDelta
Die Zeit in Takten bleibt bis zum nächsten Timeout für die erneute Übertragung (siehe RFC 2581). Beachten Sie, dass der Wert -1 unmittelbar nach dem Ausladen der TCP-Verbindung angibt, dass der Timer für die erneute Übertragung nicht ausgeführt wurde, als die Verbindung ausgeladen wurde. Der Timer für die erneute Übertragung wurde nicht ausgeführt, da beim Ausladen der Verbindung keine ausstehenden Sendedaten für die Verbindung vorhanden waren. Wenn der Timer für die Erneute Übertragung des Auslagerungsziels nicht ausgeführt wird, sollte das Auslagerungsziel -1 in diesem Member zurückgeben, wenn es auf einen Aufruf der MiniportQueryOffload-Funktion oder der MiniportTerminateOffload-Funktion reagiert.
SendDataHead
Ein Zeiger auf eine NET_BUFFER_LIST-Struktur . Diese NET_BUFFER_LIST-Struktur befindet sich in der verknüpften Liste, auf die das NetBufferListChain-Element des NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur, die unmittelbar vor der TCP_OFFLOAD_STATE_DELEGATED-Struktur steht. Wenn der NetBufferListChain-ZeigerNULL ist, ist SendDataHead nicht signifikant.
Der SendDataHead-Zeiger zeigt auf die erste NET_BUFFER_LIST-Struktur, deren NET_BUFFER-Struktur die zugeordneten Sendedaten gepuffert hat.
Diese Variable wird nur in einem Auslagerungs- oder Beendigungsvorgang verwendet. Weitere Informationen zur Verwendung dieser Variablen finden Sie unter Behandeln ausstehender Sendedaten während und nach einem Auslagerungsvorgang und Behandeln ausstehender Sendedaten während eines Beendigungsabladungsvorgangs.
SendDataTail
Ein Zeiger auf eine NET_BUFFER_LIST-Struktur . Diese NET_BUFFER_LIST-Struktur befindet sich in der verknüpften Liste, auf die das NetBufferListChain-Element der NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur verweist, die unmittelbar vor der TCP_OFFLOAD_STATE_DELEGATED-Struktur steht. Wenn der NetBufferListChain-Zeiger NULL ist, ist SendDataTail nicht signifikant.
Der SendDataTail-Zeiger zeigt auf die letzte NET_BUFFER_LIST Struktur, deren NET_BUFFER-Struktur die zugeordneten Sendedaten gepuffert hat.
Diese Variable wird nur in einem Auslagerungs- oder Beendigungsvorgang verwendet. Weitere Informationen zur Verwendung dieser Variablen finden Sie unter Behandeln ausstehender Sendedaten während und nach einem Auslagerungsvorgang und Behandeln ausstehender Sendedaten während eines Beendigungsabladevorgangs.
SendBacklogSize
Das Auslagerungsziel gibt diesen Wert an, um die Anzahl der Datenbytes anzugeben, die der Hoststapel am Auslagerungsziel für eine optimale Leistung aufweisen sollte. (Dies ist die Anzahl der Sendebytes, die an das Auslagerungsziel übergeben wurden, aber noch nicht vom Auslagerungsziel abgeschlossen wurden.) Die spezifischen Variablen und der Algorithmus, die das Auslagerungsziel zum Berechnen der Größe des Sendebacklogs verwendet, sind implementierungsspezifisch. Die Größe des Sendebacklogs kann eine Funktion der Roundtripzeit (Roundtrip Time, RTT) für die Verbindung, die Schnittstellenbandbreite und andere Parameter sein. Ein Auslagerungsziel kann z. B. das Minimum des Bandbreiten-/Verzögerungsprodukts und das angekündigte empfangene Fenster verwenden. Beachten Sie jedoch, dass die Größe des Sendebacklogs nicht abhängig von der Anzahl der Datenbytes variiert, die derzeit für die Übertragung über die Verbindung bereitgestellt werden.
Der Hoststapel kann den delegierten TCP-Zustand für die Verbindung abfragen, um die Größe des Sendebacklogs zu erhalten. Darüber hinaus kann das Auslagerungsziel eine Änderung der Größe des Sendebacklogs durch Aufrufen der NdisTcpOffloadEventHandler-Funktion .
Wenn das Auslagerungsziel die Funktion send-backlog-size nicht unterstützt, muss es den Wert 0xFFFFFFFF in SendBacklogSize schreiben, wenn der TCP-delegierte Zustand für die Verbindung abgefragt wird. Die SendBacklogSize-Variable wird im Vorgang zum Beenden des Ausladens nicht verwendet.
BufferedData
Ein Zeiger auf gepufferte Empfangsdaten. Der Hoststapel kann solche Daten beim Auslagern einer TCP-Verbindung an das Auslagerungsziel übergeben. (Weitere Informationen finden Sie unter Behandeln von gepufferten Empfangsdaten während und nach einem Auslagerungsvorgang.) Das Auslagerungsziel kann solche Daten beim Hochladen einer TCP-Verbindung an den Hoststapel übergeben. (Weitere Informationen finden Sie unter Behandeln gepufferter Empfangsdaten während eines Beendigungsabladungsvorgangs.)
ReceiveBacklogSize
Das Auslagerungsziel gibt diesen Wert an, um die Anzahl der Empfangensdatenbytes anzugeben, die im Auslagerungsziel für die ausgeladene TCP-Verbindung gepuffert werden. Der Hoststapel kann den delegierten TCP-Zustand für die Verbindung abfragen, um diesen Wert zu erhalten. Der Hoststapel verwendet diesen Wert, um eine oder mehrere Empfangsanforderungen für die Verbindung zu posten, die groß genug sind, um alle gepufferten Daten aufzunehmen.
Wenn das Auslagerungsziel das Feature "Größe des Empfangsbacklogs" nicht unterstützt, sollte es den Wert 0xFFFFFFFF in ReceiveBacklogSize schreiben.
DWnd
Hinweise
Der Hoststapel stellt Anfangswerte für die delegierten TCP-Variablen bereit, wenn er diese Variablen an das Auslagerungsziel auslädt. Nach dem Ausladen sind die delegierten TCP-Variablen im Besitz des Auslagerungsziels und werden von diesem verwaltet. Nur das Auslagerungsziel kann den Wert einer ausgeladenen delegierten TCP-Variablen ändern. Das Auslagerungsziel benachrichtigt den Hoststapel nicht über Änderungen an den Werten der ausgeladenen delegierten TCP-Variablen. Der Hoststapel kann jedoch den Wert der ausgeladenen delegierten TCP-Variablen abfragen, wodurch NDIS die MiniportQueryOffload-Funktion des Auslagerungsziels aufruft. Wenn der Hoststapel die Auslagerung des TCP-Verbindungszustandsobjekts beendet, indem NDIS die des Auslagerungsziels aufruft MiniportTerminateOffload-Funktion , das Auslagerungsziel übergibt den Wert der delegierten TCP-Variablen im beendeten TCP-Verbindungszustandsobjekt zurück an den Hoststapel.
Bei der Übergabe an ein Auslagerungsziel wird eine TCP_OFFLOAD_STATE_DELEGATED-Struktur einem zugeordnet. NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur , die einen Header enthält, der als NDIS_OBJECT_HEADER-Struktur formatiert ist. Der Revisionsmember der NDIS_OBJECT_HEADER-Struktur gibt in diesem Fall die Revisionsnummer der TCP_OFFLOAD_STATE_DELEGATED-Struktur an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ndischimney.h (include Ndischimney.h) |