NdisOffloadTcpSend-Funktion (ndischimney.h)

Artikel
02/07/2025

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

Ein Protokolltreiber oder Zwischentreiber ruft die NdisOffloadTcpSend--Funktion auf, um Daten über eine entladene TCP-Verbindung zu übertragen.

Syntax

NDIS_STATUS NdisOffloadTcpSend(
  [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 Liste der NET_BUFFER Strukturen. Jede NET_BUFFER Struktur in der Liste verweist auf eine Kette von Speicherdeskriptorlisten (MDLs). Die MDLs enthalten die zu übertragenden Daten. 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 NdisOffloadTcpSend--Funktion gibt immer NDIS_STATUS_PENDING zurück. Der Sendevorgang wird immer asynchron abgeschlossen.

Bemerkungen

Als Reaktion auf einen Aufruf der MiniportTcpOffloadSend--Funktion ruft ein Zwischentreiber die NdisOffloadTcpSend--Funktion auf, um den Sendevorgang an den zugrunde liegenden Zwischentreiber oder Offloadziel zu verteilen. Weitere Informationen finden Sie unter Verteilen von E/A-Vorgängen.

An die NdisOffloadTcpSend--Funktion übergibt der Zwischentreiber Folgendes:

Eine NdisOffloadHandle-, 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 MiniportTcpOffloadSend- funktion des Zwischentreibers übergeben hat.

Wenn das zugrunde liegende Treiber- oder Offloadziel anschließend den Sendevorgang durch Aufrufen der NdisTcpOffloadSendComplete--Funktion abschließt, ruft NDIS die ProtocolOffloadSendComplete--Funktion des Zwischentreibers auf. Der Zwischentreiber ruft dann die NdisTcpOffloadSendComplete--Funktion auf, um den Abschluss des Sendevorgangs zu verteilen.