Función NdisOffloadTcpForward (ndischimney.h)

Artículo
02/27/2024

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

Un controlador de protocolo o un controlador intermedio llama a la función NdisOffloadTcpForward para reenviar segmentos TCP recibidos no reconocidos a un controlador subyacente o un destino de descarga.

Sintaxis

NDIS_STATUS NdisOffloadTcpForward(
  [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 estructura NET_BUFFER . Cada NET_BUFFER estructura apunta a una cadena de listas de descriptores de memoria (MDL). Las MDL asociadas a una estructura de NET_BUFFER contienen uno y solo un segmento TCP que se reenvía al destino de descarga. El primer byte del primer MDL es el primer byte del encabezado TCP. 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 NdisOffloadTcpForward siempre devuelve NDIS_STATUS_PENDING. La operación de reenvío siempre se completa de forma asincrónica.

Comentarios

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

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

Función 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ó al controlador intermedio Función MiniportTcpOffloadForward .

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