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

Hinweise

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

An die Funktion NdisOffloadTcpReceive ü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 der zugrunde liegende Treiber oder das Ziel anschließend den Empfangsvorgang durch Aufrufen der Funktion NdisTcpOffloadReceiveComplete abschließt, ruft NDIS die ProtocolOffloadReceiveComplete-Funktion des Zwischentreibers auf. Der Zwischentreiber ruft dann die Funktion NdisTcpOffloadReceiveComplete auf, um den Abschluss des Vorwärtsvorgangs zu verteilen.