TCP_OFFLOAD_SEND_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
04/30/2024

[Das TCP-Chimney-Auslagerungsfeature 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 Funktion NdisOffloadTcpSend 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 für einen Kontextbereich, der vom Protokolltreiber zugeordnet ist. Der Treiber verwaltet die Kontextinformationen pro Bindung in diesem Kontextbereich. Der Treiber hat dieses Handle für NDIS bereitgestellt, 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 von NET_BUFFER_LIST Strukturen sein. Der Treiber hat diesen Zeiger als Eingabeparameter in einem vorherigen Aufruf der NdisOffloadTcpSend-Funktion angegeben.

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Treibers oder des Auslagerungsziels an den NdisOffloadTcpSendComplete-Funktion , NDIS ruft 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 Funktion NdisOffloadTcpSendComplete 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 Antwort ruft NDIS die ProtocolTcpOffloadSendComplete-Funktion des überlagernden Treibers auf und übergibt ein ProtocolBindingContext-Handle und den vom Zwischentreiber bereitgestellten PNET_BUFFER_LIST-Zeiger an die NdisOffloadTcpSendComplete-Funktion .