Función NdisOffloadTcpReceive (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 un controlador intermedio llama a la función NdisOffloadTcpReceive para publicar solicitudes de recepción (búferes de recepción) en una conexión TCP descargada.

Sintaxis

NDIS_STATUS NdisOffloadTcpReceive(
  [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 NET_BUFFER_LIST . Esta estructura puede ser una estructura independiente o la primera estructura de una lista vinculada de NET_BUFFER_LIST estructuras. Cada estructura NET_BUFFER_LIST de la lista describe una estructura NET_BUFFER . La estructura NET_BUFFER apunta a una cadena de listas de descriptores de memoria (MDL). 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 NdisOffloadTcpReceive siempre devuelve NDIS_STATUS_PENDING. La operación de recepción siempre se completa de forma asincrónica.

Comentarios

En respuesta a una llamada a su MiniportTcpOffloadReceive , un controlador intermedio llama a la función NdisOffloadTcpReceive para propagar la operación de recepción 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 NdisOffloadTcpReceive , el controlador intermedio pasa lo siguiente:

Función NdisOffloadHandle que hace referencia a la estructura 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 MiniportTcpOffloadReceive del controlador intermedio.

Cuando el controlador subyacente o el destino de descarga finalizan posteriormente la operación de recepción mediante una llamada a la función NdisTcpOffloadReceiveComplete , NDIS llama a la función ProtocolOffloadReceiveComplete del controlador intermedio. A continuación, el controlador intermedio llama a la función NdisTcpOffloadReceiveComplete para propagar la finalización de la operación de reenvío.