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

Artículo
08/07/2023

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

NDIS llama a la función ProtocolTcpOffloadDisconnectComplete de un controlador de protocolo o a un controlador intermedio para completar una operación de desconexión que el controlador inició anteriormente 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 única estructura de NET_BUFFER_LIST . El controlador proporcionó este puntero como parámetro de entrada en una llamada anterior a . Función NdisOffloadTcpDisconnect .

Valor devuelto

None

Observaciones

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

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

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 ProtocolTcpOffloadDisconnectComplete del controlador excesiva, pasando un identificador ProtocolBindingContext y el puntero PNET_BUFFER_LIST pasado por el controlador intermedio a la función NdisOffloadTcpDisconnectComplete .

Antes de devolver, 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 excesivamente remotos, 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.