NdisOffloadTcpForward-Funktion (ndischimney.h)

Artikel
02/26/2024

[Das TCP-Chimney-Auslagerungsfeature 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 Einlagerungsziel weiterzuleiten.

Syntax

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

Parameter

[in] NdisOffloadHandle

Ein Handle für 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 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 nur ein TCP-Segment, das an das Auslagerungsziel 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 sich im physischen Speicher befinden. Sie werden jedoch nicht dem Systemspeicher zugeordnet.

Rückgabewert

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

Hinweise

Als Reaktion auf einen Aufruf seiner MiniportTcpOffloadForward-Funktion ruft ein Zwischentreiber die NdisOffloadTcpForward-Funktion auf, um den Forward-Vorgang an den zugrunde liegenden Treiber oder das Ziel zu verteilen. 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 zwischengeschalteten Treiber übergeben hat MiniportTcpOffloadForward-Funktion .

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