NdisOffloadTcpDisconnect-Funktion (ndischimney.h)

Artikel
02/26/2024

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

Ein Protokoll- oder Zwischentreiber ruft die NdisOffloadTcpDisconnect-Funktion auf, um die Sendehälfte einer entladenen TCP-Verbindung zu schließen. Wenn es sich bei der durchzuführenden Trennung um eine ordnungsgemäße Trennung handelt, kann der Protokoll- oder Zwischentreiber Außerdem Anwendungsdaten bereitstellen, die das zugrunde liegende Auslagerungsziel auf die entladene TCP-Verbindung übertragen muss, bevor ein FIN-Segment gesendet wird.

Syntax

NDIS_STATUS NdisOffloadTcpDisconnect(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList,
  [in] IN ULONG                Flags
);

Parameter

[in] NdisOffloadHandle

Ein Zeiger auf eine NDIS_OFFLOAD_HANDLE Struktur im Kontext des Aufrufers für die entladene TCP-Verbindung. Weitere Informationen finden Sie unter Verweisen auf den ausgeladenen Zustand über einen Zwischentreiber.

[in] NetBufferList

Ein Zeiger auf eine einzelne NET_BUFFER_LIST-Struktur . Dieser NET_BUFFER_LIST-Struktur ist nur eine NET_BUFFER Struktur zugeordnet.

[in] Flags

Als einer der folgenden Werte gilt der Typ der durchzuführenden Trennung:

TCP_DISCONNECT_ABORTIVE_CLOSE

Gibt an, dass das Auslagerungsziel eine abgebrochene Trennung durch Senden eines RST-Segments ausführt.

TCP_DISCONNECT_GRACEFUL_CLOSE

Gibt an, dass das Auslagerungsziel eine ordnungsgemäße Trennung durchführt, indem ein FIN-Segment gesendet wird.

Rückgabewert

Die Funktion NdisOffloadTcpDisconnect gibt immer NDIS_STATUS_PENDING zurück. Der Verbindungsvorgang wird immer asynchron abgeschlossen.

Hinweise

Als Reaktion auf einen Aufruf an MiniportTcpOffloadDisconnect-Funktion , ein Zwischentreiber ruft die NdisOffloadTcpDisconnect-Funktion auf, um den Trennungsvorgang an den zugrunde liegenden Zwischentreiber oder das Ziel zu verteilen. Weitere Informationen finden Sie unter Verteilen von E/A-Vorgängen.

An die NdisOffloadTcpXxx-Funktion übergibt der zwischengeschaltete Treiber Folgendes:

Eine NdisOffloadHandle-Funktion , die auf die NDIS_OFFLOAD_HANDLE Struktur verweist, die im Kontext des Zwischentreibers für die entladene TCP-Verbindung gespeichert ist. Weitere Informationen finden Sie unter Verweisen auf den ausgeladenen Zustand über einen Zwischentreiber.
Derselbe PNET_BUFFER_LIST Zeiger, den NDIS an die MiniportTcpOffloadDisconnect-Funktion des Zwischentreibers übergeben hat.
Dieselben Flags , die NDIS an die MiniportTcpOffloadDisconnect-Funktion des zwischengeschalteten Treibers übergeben hat.

Wenn der zugrunde liegende Treiber oder das Entladungsziel anschließend den Verbindungsvorgang durch Aufrufen der Funktion NdisTcpOffloadDisconnectComplete abschließt, ruft NDIS die ProtocolOffloadDisconnectComplete-Funktion des Zwischentreibers auf. Der Zwischentreiber ruft dann die Funktion NdisTcpOffloadDisconnectComplete auf, um den Abschluss des Verbindungsvorgangs zu verteilen.