NdisOffloadTcpReceiveReturn-Funktion (ndischimney.h)

Artikel
02/29/2024

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

Ein Protokolltreiber oder Zwischentreiber ruft die NdisOffloadTcpReceiveReturn-Funktion auf, um den Besitz von NET_BUFFER_LIST und zugeordneten Strukturen an ein zugrunde liegendes Auslagerungsziel zurückzugeben.

Syntax

void NdisOffloadTcpReceiveReturn(
  [in] IN NDIS_HANDLE      NdisBindingHandle,
  [in] IN PNET_BUFFER_LIST NetBufferList
);

Parameter

[in] NdisBindingHandle

Das Handle, das NDIS am NdisBindingHandle-Parameter der NdisOpenAdapterEx-Funktion bereitgestellt hat. Mit diesem Handle wird die Bindung zwischen dem Aufrufer und dem zugrunde liegenden Zwischentreiber oder -auslagerungsziel identifiziert.

[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. Die verknüpfte Liste kann NET_BUFFER_LIST Strukturen aus einem oder mehreren Aufrufen der NdisTcpOffloadReceiveHandler-Funktion .

Rückgabewert

Die Funktion NdisOffloadTcpReceiveReturn gibt immer NDIS_STATUS_SUCCESS zurück. Der Empfangsrückgabevorgang wird immer synchron abgeschlossen.

Hinweise

Als Reaktion auf einen Aufruf an MiniportTcpOffloadReceiveReturn-Funktion , ein Zwischentreiber ruft die NdisOffloadTcpReceiveReturn-Funktion auf, um den Empfangsrückgabevorgang an den zugrunde liegenden Zwischentreiber oder das Auslagerungsziel weiterzuleiten. Weitere Informationen finden Sie unter Verteilen von E/A-Vorgängen.

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