Función NdisOffloadTcpReceive (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 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 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 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.

Observaciones

En respuesta a una llamada a su función 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, 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 miniportTcpOffloadRece ive del controlador intermedio.

Cuando el controlador subyacente o el destino de descarga completan posteriormente la operación de recepción llamando 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.