TERMINATE_OFFLOAD_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 un protocolo o a la función ProtocolTerminateOffloadComplete del controlador intermedio para completar una operación de descarga de finalización que el controlador inició anteriormente mediante una llamada a la función NdisTerminateOffload .

Sintaxis

TERMINATE_OFFLOAD_COMPLETE_HANDLER TerminateOffloadCompleteHandler;

void TerminateOffloadCompleteHandler(
  [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 este á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 estas estructuras. Estas estructuras identifican el estado finalizado o que se intentó terminar.

Valor devuelto

None

Observaciones

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

Un controlador intermedio debe propagar la finalización de la operación de descarga de finalización al controlador anterior mediante una llamada a NdisMTerminateOffloadComplete. 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 ProtocolTerminateOffloadComplete , 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 NdisMTerminateOffloadComplete , el controlador intermedio pasa un puntero (el parámetro OffloadBlockList ) a esta estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST recién construida.