Función NdisOffloadTcpSend (ndischimney.h)

Artículo
08/07/2023

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

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 de NDIS_OFFLOAD_HANDLE en el contexto del autor de la llamada para la conexión TCP descargada. Para obtener más información, vea Hacer referencia al estado descargado a través de un controlador intermedio.

[in] NetBufferList

Puntero a una estructura de 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 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.

Comentarios

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, vea 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 MiniportTcpOffloadSend 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 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.