TCP_OFFLOAD_RECV_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/26/2024

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

NDIS ruft die ProtocolTcpOffloadReceiveComplete-Funktion eines Protokoll- oder Zwischentreibers auf, um einen Empfangsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisOffloadTcpReceive-Funktion initiiert hat .

Syntax

TCP_OFFLOAD_RECV_COMPLETE_HANDLER TcpOffloadRecvCompleteHandler;

void TcpOffloadRecvCompleteHandler(
  [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 des NdisOffloadTcpReceive-Funktion .

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Treibers oder des Auslagerungsziels an den NdisOffloadTcpReceiveComplete-Funktion , NDIS ruft die ProtocolTcpOffloadReceiveComplete-Funktion des überlagernden Protokolltreibers oder Zwischentreibers auf.

Um den Abschluss des E/A-Vorgangs an den überlagernden Treiber zu verteilen, ruft der Zwischentreiber selbst die Funktion NdisOffloadTcpReceiveComplete 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 ProtocolTcpOffloadReceiveComplete-Funktion des Zwischentreibers übergeben hat.

Als Antwort ruft NDIS die ProtocolTcpOffloadReceiveComplete-Funktion des überlagernden Treibers auf und übergibt ein ProtocolBindingContext-Handle und den vom Zwischentreiber bereitgestellten PNET_BUFFER_LIST-Zeiger an die NdisOffloadTcpReceiveComplete-Funktion .