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

Artículo
03/08/2023

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

NDIS llama a la función ProtocolInitiateOffloadComplete de un controlador de protocolo o a un controlador intermedio para completar una operación de descarga que el controlador inició anteriormente llamando a la función NdisInitiateOffload .

Sintaxis

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [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 una estructura de NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST que puede ser una estructura independiente o la raíz de una lista vinculada de estas estructuras. Estas estructuras identifican el estado descargado o que se intentó descargar.

Valor devuelto

None

Observaciones

En respuesta a la llamada de un controlador intermedio o del destino de descarga subyacente a la función NdisMInitiateOffloadComplete , NDIS llama a la función ProtocolInitiateOffloadComplete del controlador intermedio o del protocolo excesivo.

Un controlador intermedio debe propagar la finalización de la operación de descarga de inicio al controlador anterior mediante una llamada a NdisMInitiateOffloadComplete. 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 ProtocolInitiateOffloadComplete , el controlador intermedio construye una estructura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST .

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