TCP_OFFLOAD_DISCONNECT_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 ProtocolTcpOffloadDisconnectComplete--Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen getrennten Vorgang 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 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

Wenn kein NULL-Wert besteht, zeigt ein Zeiger auf eine einzelne NET_BUFFER_LIST Struktur. Der Treiber hat diesen Zeiger als Eingabeparameter in einem vorherigen Aufruf des NdisOffloadTcpDisconnect Funktion.

Rückgabewert

Nichts

Bemerkungen

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

Um den Abschluss des Verbindungsvorgangs an den Überlagerungstreiber zu verteilen, ruft der Zwischentreiber die NdisOffloadTcpDisconnectComplete--Funktion auf, wobei Folgendes übergeben wird:

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 Reaktion ruft NDIS die ProtocolTcpOffloadDisconnectComplete--Funktion des überlagernden Treibers auf und übergibt eine ProtocolBindingContext- Handle und den PNET_BUFFER_LIST Zeiger, der vom Zwischentreiber an die NdisOffloadTcpDisconnectComplete Funktion übergeben wird.

Vor dem Zurückgeben sollte die ProtocolTcpOffloadDisconnectComplete--Funktion den Speicher für jeden Kontext, den sie für die an die Funktion übergebene NET_BUFFER_LIST-Struktur erstellt hat, behandeln.

Beachten Sie, dass ein Zwischentreiber, der mehrere Schnittstellen in Überlyingprotokolle exportiert, bestimmen muss, welches Protokoll den Abschluss der Verbindung erhalten soll. Um diese Bestimmung zu treffen, verwendet der Zwischentreiber Informationen, die er im NET_BUFFER_LIST_CONTEXT Struktur, die der NET_BUFFER_LIST Struktur zugeordnet ist.