W_TERMINATE_OFFLOAD_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.]

La función MiniportTerminateOffload finaliza la descarga de uno o varios objetos de estado.

Sintaxis

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parámetros

[in] MiniportAdapterContext

Identificador de un área de contexto asignada de destino de descarga en la que el destino de descarga mantiene información de estado sobre esta instancia del adaptador. El destino de descarga proporcionó este identificador a NDIS cuando llamó NdisMSetMiniportAttributes de su Función MiniportInitializeEx .

[in, out] OffloadBlockList

Puntero a un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura, que puede ser la raíz de una lista vinculada de estas estructuras. Estas estructuras identifican los objetos de estado descargados que se están finalizando.

Valor devuelto

None

Observaciones

La función MiniportTerminateOffload almacena el puntero OffloadBlockList y, a continuación, devuelve. El destino de descarga siempre completa la operación de finalización de forma asincrónica mediante una llamada a Función NdisMTerminateOffloadComplete .

El puntero OffloadBlockList apunta a una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST que puede ser una estructura independiente o la lista de bloques raíz en un árbol de estado de descarga que contiene varias estructuras de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Estas listas de bloques, así como las estructuras de estado de descarga asociadas a ellas, son válidas hasta que el controlador de miniporte llama a la función NdisMTerminateOffloadComplete .

Cada estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST puede seguir inmediatamente en memoria una estructura de estado delegada (XXX_OFFLOAD_STATE_DELEGATED). El destino de descarga copia los valores de variable delegados en las estructuras de estado delegadas proporcionadas por la pila de hosts.

La pila de hosts no solicitará la finalización de la descarga de una conexión TCP hasta que se cumplan las dos condiciones siguientes:

Todas las solicitudes pendientes de invalidación, consulta y actualización relacionadas con esa conexión se han completado.
Se han devuelto todas las llamadas pendientes de recepción y desconexión.