TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/29/2024

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

NDIS ruft die ProtocolTcpOffloadForwardComplete-Funktion eines Protokoll- oder Zwischentreibers auf, um einen Weiterleitungsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der 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 zugeordnet wird. Der Treiber verwaltet die Kontextinformationen pro Bindung in diesem Kontextbereich. Der Treiber hat dieses Handle für NDIS bereitgestellt, als 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 von NET_BUFFER_LIST Strukturen sein. Der Treiber hat diesen Zeiger als Eingabeparameter in einem vorherigen Aufruf der NdisOffloadTcpForward-Funktion bereitgestellt.

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf der NdisOffloadTcpForwardComplete-Funktion eines zugrunde liegenden Treibers oder Auslagerungsziels ruft NDIS die ProtocolTcpOffloadForwardComplete-Funktion des übergeordneten Protokolltreibers oder zwischengeschalteten Treibers auf.

Um den Abschluss des Weiterleitungsvorgangs an den übergeordneten Treiber oder Hoststapel weiterzugeben, ruft der Zwischentreiber die Funktion NdisOffloadTcpForwardComplete 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 Antwort ruft NDIS die ProtocolTcpOffloadForwardComplete-Funktion des übergeordneten Treibers oder Hoststapels auf und übergibt ein ProtocolBindingContext-Handle und den vom Zwischentreiber bereitgestellten PNET_BUFFER_LIST-Zeiger an die Funktion NdisOffloadTcpForwardComplete .