TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/07/2025

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

NDIS ruft die ProtocolTcpOffloadForwardComplete--Funktion eines Protokoll- oder Zwischentreibers auf, um einen Vorwärtsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen des Aufrufs des Treibers initiiert hat. NdisOffloadTcpForward Funktion.

Syntax

TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER TcpOffloadForwardCompleteHandler;

void TcpOffloadForwardCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parameter

[in] ProtocolBindingContext

Ein Handle zu einem Kontextbereich, der vom Protokolltreiber zugewiesen wird. Der Treiber behält die Informationen zu bindungskontextbezogenen Informationen in diesem Kontextbereich bei. Der Treiber hat diesen Handle an NDIS übergeben, wenn der Treiber die NdisOpenAdapterEx--Funktion aufgerufen hat.

[in] NetBufferList

Ein Zeiger auf eine NET_BUFFER_LIST Struktur. Diese Struktur kann eigenständig oder die erste Struktur in einer verknüpften Liste mit NET_BUFFER_LIST Strukturen sein. Der Treiber hat diesen Zeiger als Eingabeparameter in einem vorherigen Aufruf des NdisOffloadTcpForward--Funktion bereitgestellt.

Rückgabewert

Nichts

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Treibers oder Offloads an den NdisOffloadTcpForwardComplete--Funktion ruft NDIS die ProtocolTcpOffloadForwardComplete-Funktion des überlagernden Protokolltreibers oder Zwischentreibers auf.

Um den Abschluss des Weiterleitungsvorgangs an den überlagernden Treiber oder Hoststapel zu verteilen, ruft der Zwischentreiber die NdisOffloadTcpForwardComplete--Funktion auf und übergibt Folgendes:

Ein ProtocolBindingContext-, bei dem es sich um ein Handle handelt, das den Zwischentreiber eindeutig identifiziert.
Der PNET_BUFFER_LIST Zeiger, den NDIS an die ProtocolTcpOffloadForwardComplete- funktion des Zwischentreibers übergeben hat.

Als Reaktion ruft NDIS die ProtocolTcpOffloadForwardComplete--Funktion des überlagernden Treibers oder Hoststapels auf und übergibt eine ProtocolBindingContext- Handle und den vom Zwischentreiber bereitgestellten PNET_BUFFER_LIST Zeiger auf die NdisOffloadTcpForwardComplete--Funktion.