Función NdisOffloadTcpSend (ndischimney.h)

Artículo
02/07/2025

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

Un controlador de protocolo o controlador intermedio llama a la función NdisOffloadTcpSend para transmitir datos en una conexión TCP descargada.

Sintaxis

NDIS_STATUS NdisOffloadTcpSend(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Parámetros

[in] NdisOffloadHandle

Identificador de una estructura NDIS_OFFLOAD_HANDLE en el contexto del autor de la llamada para la conexión TCP descargada. Para obtener más información, consulte hacer referencia al estado descargado a través de un controlador intermedio.

[in] NetBufferList

Puntero a una estructura NET_BUFFER_LIST. Esta estructura puede ser una estructura independiente o la primera estructura de una lista vinculada de estructuras de NET_BUFFER_LIST. Cada estructura NET_BUFFER_LIST de la lista describe una lista de estructuras de NET_BUFFER. Cada NET_BUFFER estructura de la lista apunta a una cadena de listas de descriptores de memoria (MDL). Las MDL contienen los datos que se van a transmitir. La NET_BUFFER_LIST y las estructuras asociadas están bloqueadas para que permanezcan residentes en la memoria física. Sin embargo, no se asignan a la memoria del sistema.

Valor devuelto

La función NdisOffloadTcpSend siempre devuelve NDIS_STATUS_PENDING. La operación de envío siempre se completa de forma asincrónica.

Observaciones

En respuesta a una llamada a su función miniportTcpOffloadSend, un controlador intermedio llama a la función NdisOffloadTcpSend para propagar la operación de envío al controlador intermedio subyacente o al destino de descarga. Para obtener más información, consulte propagación de operaciones de E/S.

Para la función NdisOffloadTcpSend, el controlador intermedio pasa lo siguiente:

NdisOffloadHandle que hace referencia a la estructura de NDIS_OFFLOAD_HANDLE almacenada en el contexto del controlador intermedio para la conexión TCP descargada. Para obtener más información, consulte hacer referencia al estado descargado a través de un controlador intermedio.
El mismo puntero PNET_BUFFER_LIST que NDIS pasó a la función MiniportTcpOffloadS end del controlador intermedio.

Cuando el controlador subyacente o el destino de descarga completan posteriormente la operación de envío llamando a la función de NdisTcpOffloadSendComplete, NDIS llama a la función ProtocolOffloadSendComplete del controlador intermedio. A continuación, el controlador intermedio llama a la función NdisTcpOffloadSendComplete para propagar la finalización de la operación de envío.