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

Artículo
02/26/2024

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

NDIS llama a la función ProtocolInvalidateOffloadComplete de un controlador de protocolo o intermedio para completar una operación de invalidación que el controlador inició anteriormente mediante una llamada a la función NdisInvalidateOffload .

Sintaxis

INVALIDATE_OFFLOAD_COMPLETE_HANDLER InvalidateOffloadCompleteHandler;

void InvalidateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

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 esta área de contexto. El controlador proporcionó este identificador a NDIS cuando el controlador llamó a la función NdisOpenAdapterEx .

[in] OffloadBlockList

Puntero a un NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST estructura que puede ser una estructura independiente o la raíz de una lista vinculada de dichas estructuras. Estas estructuras identifican el estado que se invalidó o que se intentó invalidar.

Valor devuelto

None

Observaciones

En respuesta a la llamada del controlador intermedio o del destino de descarga subyacente a Función NdisMInvalidateOffloadComplete , NDIS llama al protocolo excesivo o al controlador intermedio
Función ProtocolInvalidateOffloadComplete .

Un controlador intermedio debe propagar la finalización de la operación de descarga de inicio al controlador anterior mediante una llamada a NdisMInvalidateOffloadComplete. Para obtener más información, vea Propagación de la finalización de una operación de State-Manipulation.

Desde la estructura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST que se pasó a su función ProtocolInvalidateOffloadComplete , el controlador intermedio construye un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura. Para obtener más información, consulte Reutilización de una estructura de NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Al llamar a la función NdisMInvalidateOffloadComplete , el controlador intermedio pasa un puntero (el parámetro OffloadBlockList ) a esta estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST recién construida.