Función NdisInitiateOffload (ndischimney.h)

Artículo
02/07/2025

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

Un protocolo o controlador intermedio llama a la función NdisInitiateOffload para descargar objetos de estado de chimenea TCP.

Sintaxis

void NdisInitiateOffload(
  [in]      IN NDIS_HANDLE                           NdisBindingHandle,
  [in, out] IN OUT PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
);

Parámetros

[in] NdisBindingHandle

Identificador que proporciona NDIS en el parámetro NdisBindingHandle de de NdisOpenAdapterEx. Este identificador identifica el enlace entre el autor de la llamada y el controlador intermedio subyacente o el destino de descarga.

[in, out] 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 que se está descargando.

Valor devuelto

Ninguno

Observaciones

Un controlador intermedio llama a la función NdisInitiateOffload para propagar una operación de descarga de inicio iniciada por la pila de hosts. Para obtener más información, consulte Propagación de State-Manipulation Operations.

Del NDIS_MINIPORT_OFFLOAD_BLOCK_LIST estructura que se pasó a su función MiniportInitiateOffload, el controlador intermedio construye una estructura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Para obtener más información, consulte Reutilización de una estructura de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. El controlador intermedio pasa un puntero (el parámetro OffloadBlockList) a esta estructura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST al llamar a la función NdisInitiateOffload.