TCP_OFFLOAD_SEND_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
07.02.2025

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

NDIS ruft die ProtocolTcpOffloadSendComplete- funktion eines Protokoll- oder Zwischentreibers auf, um einen Sendevorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisOffloadTcpSend--Funktion initiiert hat.

Syntax

TCP_OFFLOAD_SEND_COMPLETE_HANDLER TcpOffloadSendCompleteHandler;

void TcpOffloadSendCompleteHandler(
  [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 NdisOffloadTcpSend-Funktion bereitgestellt.

Rückgabewert

Nichts

Bemerkungen

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

Um den Abschluss des E/A-Vorgangs an den überlagernden Treiber oder Hoststapel weiterzugeben, ruft der Zwischentreiber selbst die NdisOffloadTcpSendComplete--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 ProtocolTcpOffloadSendComplete- funktion des Zwischentreibers übergeben hat.

Als Reaktion ruft NDIS die ProtocolTcpOffloadSendComplete--Funktion des überlagernden Treibers auf, übergibt ein ProtocolBindingContext- Handle und den PNET_BUFFER_LIST Zeiger, der vom Zwischentreiber an die NdisOffloadTcpSendComplete-Funktion bereitgestellt wird.