TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
08/07/2023

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

NDIS ruft die ProtocolTcpOffloadDisconnectComplete-Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Trennungsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisOffloadTcpDisconnect-Funktion .

Syntax

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [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

Wenn nicht NULL, ein Zeiger auf eine einzelne NET_BUFFER_LIST Struktur. Der Treiber hat diesen Zeiger als Eingabeparameter in einem vorherigen Aufruf von bereitgestellt. NdisOffloadTcpDisconnect-Funktion .

Rückgabewert

Keine

Bemerkungen

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

Um den Abschluss des Trennungsvorgangs an den übergeordneten Treiber weiterzugeben, ruft der Zwischentreiber die Funktion NdisOffloadTcpDisconnectComplete auf und übergibt Folgendes:

Ein ProtocolBindingContext, bei dem es sich um ein Handle handelt, das den Zwischentreiber eindeutig identifiziert.
Derselbe PNET_BUFFER_LIST Zeiger, den NDIS an die ProtocolTcpOffloadDisconnectComplete-Funktion des Zwischentreibers übergeben hat.

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

Vor der Rückgabe sollte die Funktion ProtocolTcpOffloadDisconnectComplete die Zuordnung des Arbeitsspeichers für jeden Kontext aufheben, den sie für die NET_BUFFER_LIST-Struktur erstellt hat, die an die Funktion übergeben wurde.

Beachten Sie, dass, wenn ein Zwischentreiber mehr als eine Schnittstelle in überlastende Protokolle exportiert, bestimmen muss, welches Protokoll den Abschluss der Trennung erhalten soll. Um diese Bestimmung zu treffen, verwendet der Zwischentreiber Informationen, die er in der NET_BUFFER_LIST_CONTEXT Struktur, die der NET_BUFFER_LIST-Struktur zugeordnet ist.