NdisOffloadTcpForward-Funktion (ndischimney.h)

Artikel
02/07/2025

[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]

Ein Protokolltreiber oder ein Zwischentreiber ruft die NdisOffloadTcpForward Funktion auf, um nicht erkannte empfangene TCP-Segmente an einen zugrunde liegenden Treiber oder Offload-Ziel weiterzuleiten.

Syntax

NDIS_STATUS NdisOffloadTcpForward(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Parameter

[in] NdisOffloadHandle

Ein Handle zu einer 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 NET_BUFFER_LIST Struktur. Diese Struktur kann eine eigenständige Struktur oder die erste Struktur in einer verknüpften Liste von NET_BUFFER_LIST Strukturen sein. Jede NET_BUFFER_LIST Struktur in der Liste beschreibt eine NET_BUFFER Struktur. Jede NET_BUFFER Struktur verweist auf eine Kette von Speicherdeskriptorlisten (MDLs). Die mdLs, die einer NET_BUFFER Struktur zugeordnet sind, enthalten ein und nur ein TCP-Segment, das an das Offloadziel weitergeleitet wird. Das erste Byte der ersten MDL ist das erste Byte des TCP-Headers. Die NET_BUFFER_LIST und zugeordneten Strukturen sind gesperrt, sodass sie im physischen Speicher verbleiben. Sie werden jedoch nicht im Systemspeicher zugeordnet.

Rückgabewert

Die funktion NdisOffloadTcpForward gibt immer NDIS_STATUS_PENDING zurück. Der Vorwärtsvorgang wird immer asynchron abgeschlossen.

Bemerkungen

Als Reaktion auf einen Aufruf der MiniportTcpOffloadForwardForward-Funktion ruft ein Zwischentreiber die NdisOffloadTcpForward-Funktion auf, um den Weiterleitungsvorgang an den zugrunde liegenden Treiber oder offload-Ziel weiterzuleiten. Weitere Informationen finden Sie unter Verteilen von E/A-Vorgängen.

An die NdisOffloadTcpForward-Funktion übergibt der Zwischentreiber 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 den Zwischentreiber übergeben hat MiniportTcpOffloadForward Funktion.

Wenn das zugrunde liegende Treiber- oder Offloadziel anschließend den Weiterleitungsvorgang durch Aufrufen der NdisTcpOffloadForwardComplete--Funktion abschließt, ruft NDIS die ProtocolOffloadForwardComplete-Funktion des Zwischentreibers auf. Der Zwischentreiber ruft dann die NdisTcpOffloadForwardComplete--Funktion auf, um den Abschluss des Vorwärtsvorgangs zu verteilen.