NdisOffloadTcpSend-Funktion (ndischimney.h)

Artikel
02/29/2024

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

Ein Protokolltreiber oder Zwischentreiber ruft die NdisOffloadTcpSend-Funktion auf, um Daten über eine ausgeladene 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 für eine NDIS_OFFLOAD_HANDLE-Struktur im Kontext des Aufrufers für die ausgeladene 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 . Bei dieser Struktur kann es sich um eine eigenständige Struktur oder die erste Struktur in einer verknüpften Liste von NET_BUFFER_LIST Strukturen handeln. 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 die zugeordneten Strukturen sind gesperrt, sodass sie im physischen Speicher verbleiben. Sie werden jedoch nicht dem Systemspeicher zugeordnet.

Rückgabewert

Die NdisOffloadTcpSend-Funktion gibt immer NDIS_STATUS_PENDING zurück. Der Sendevorgang wird immer asynchron abgeschlossen.

Hinweise

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

An die NdisOffloadTcpSend-Funktion übergibt der Zwischentreiber Folgendes:

Ein NdisOffloadHandle , der auf die NDIS_OFFLOAD_HANDLE-Struktur verweist, die im Kontext des Zwischentreibers für die ausgeladene 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 der zugrunde liegende Treiber oder Auslagerungsziel den Sendevorgang anschließend durch Aufrufen der Funktion NdisTcpOffloadSendComplete abschließt, ruft NDIS die ProtocolOffloadSendComplete-Funktion des Zwischentreibers auf. Der Zwischentreiber ruft dann die NdisTcpOffloadSendComplete-Funktion auf, um den Abschluss des Sendevorgangs weiterzuverbreiten.