TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER función de devolución de llamada (ndischimney.h)

Artículo
02/07/2025

[La característica de descarga de chimenea TCP está en desuso y no debe usarse].

NDIS llama a la función de ProtocolTcpOffloadDisconnectComplete de un controlador de protocolo o de un controlador intermedio para completar una operación de desconexión iniciada anteriormente por el controlador llamando a función NdisOffloadTcpDisconnect.

Sintaxis

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parámetros

[in] ProtocolBindingContext

Identificador de un área de contexto asignada por el controlador de protocolo. El controlador mantiene la información de contexto por enlace en este área de contexto. El controlador proporcionó este identificador a NDIS cuando el controlador llamó a la función NdisOpenAdapterEx.

[in] NetBufferList

Cuando no es NULL, un puntero a una sola estructura NET_BUFFER_LIST. El controlador proporcionó este puntero como parámetro de entrada en una llamada anterior a . función NdisOffloadTcpDisconnect.

Valor devuelto

Ninguno

Observaciones

En respuesta a la llamada del destino de descarga o del controlador subyacente a función NdisTcpOffloadDisconnectComplete, NDIS llama a la función ProtocolTcpOffloadDisconnectComplete controlador de protocolo excesivo o intermedio.

Para propagar la finalización de la operación de desconexión al controlador sobrepuesto, el controlador intermedio llama a la función NdisOffloadTcpDisconnectComplete, pasando lo siguiente:

Un ProtocolBindingContext, que es un identificador que identifica de forma única el controlador intermedio.
El mismo puntero PNET_BUFFER_LIST que NDIS pasó a la función ProtocolTcpOffloadDisconnectComplete del controlador intermedio.

En respuesta, NDIS llama a la función de ProtocolTcpOffloadDisconnectComplete del controlador, pasando un controlador ProtocolBindingContext y el puntero PNET_BUFFER_LIST pasado por el controlador intermedio a la función NdisOffloadTcpDisconnectComplete.

Antes de devolverlo, la función ProtocolTcpOffloadDisconnectComplete debe desasignar la memoria para cualquier contexto que creó para la estructura de NET_BUFFER_LIST que se pasó a la función.

Tenga en cuenta que, si un controlador intermedio exporta más de una interfaz a protocolos demasiado excesivos, debe determinar qué protocolo debe recibir la finalización de la desconexión. Para realizar esta determinación, el controlador intermedio usa información que almacena en el NET_BUFFER_LIST_CONTEXT estructura, que está asociada a la estructura NET_BUFFER_LIST.