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

La función MiniportUpdateOffload actualiza los objetos de estado de chimenea TCP descargados previamente.

Sintaxis

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parámetros

[in] MiniportAdapterContext

Identificador de un área de contexto asignada por 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] 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 actualizando. Solo se actualizan las variables almacenadas en caché.

Valor devuelto

Ninguno

Observaciones

Solo se actualizan las variables almacenadas en caché.

La función MiniportUpdateOffload almacena el identificador de MiniportAdapterContext y el puntero de OffloadBlockList y, a continuación, devuelve. El destino de descarga siempre completa la operación de actualización de forma asincrónica llamando a . función NdisMUpdateOffloadComplete. El puntero de 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 de que están asociadas a ellas, son válidas hasta que el controlador de miniporte llama a la función NdisMUpdateOffloadComplete.

Antes de que se devuelva la función MiniportUpdateOffload, el destino de descarga usa el árbol de estado de descarga pasado a la función MiniportUpdateOffload para actualizar el estado descargado:

El destino de descarga copia los valores de variable de cualquier estructura de estado del árbol en los objetos de estado descargados de correspondientes. Solo se actualizan las variables CACHED.
El árbol puede indicar que se deben actualizar los vínculos de ruta de acceso a vecino. Para obtener más información, vea vincular objetos de estado de ruta de acceso a un nuevo objeto de estado vecino. En este caso, el destino de descarga debe actualizar su representación interna del estado descargado para reflejar los vínculos actualizados.