NdisOffloadTcpReceive-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 NdisOffloadTcpReceive--Funktion auf, um Anforderungen (Empfangspuffer) für eine entladene TCP-Verbindung zu posten.

Syntax

NDIS_STATUS NdisOffloadTcpReceive(
  [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. Die NET_BUFFER Struktur verweist auf eine Kette von Speicherdeskriptorlisten (MDLs). 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 NdisOffloadTcpReceive gibt immer NDIS_STATUS_PENDING zurück. Der Empfangsvorgang wird immer asynchron abgeschlossen.

Bemerkungen

Als Reaktion auf einen Aufruf an seine MiniportTcpOffloadReceive-Funktion ruft ein Zwischentreiber die NdisOffloadTcpReceive-Funktion auf, um den Empfangsvorgang an den zugrunde liegenden Zwischentreiber oder offload-Ziel weiterzuleiten. Weitere Informationen finden Sie unter Verteilen von E/A-Vorgängen.

An die NdisOffloadTcpReceive-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 die MiniportTcpOffloadReceive-Funktion des Zwischentreibers übergeben hat.

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