TCP_OFFLOAD_RECV_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 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 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 NdisOffloadTcpReceive Funktion.

Rückgabewert

Nichts

Bemerkungen

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

Um den Abschluss des E/A-Vorgangs an den Überlagerungstreiber weiterzuleiten, ruft der Zwischentreiber selbst die NdisOffloadTcpReceiveComplete-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 ProtocolTcpOffloadReceiveComplete- funktion des Zwischentreibers übergeben hat.

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