TCP_OFFLOAD_RECV_COMPLETE_HANDLER fonction de rappel (ndischimney.h)

Article
02/26/2024

[La fonctionnalité de déchargement de cheminée TCP est déconseillée et ne doit pas être utilisée.]

NDIS appelle la fonction ProtocolTcpOffloadReceiveComplete d’un protocole ou d’un pilote intermédiaire pour effectuer une opération de réception que le pilote a précédemment lancée en appelant la fonction NdisOffloadTcpReceive .

Syntaxe

TCP_OFFLOAD_RECV_COMPLETE_HANDLER TcpOffloadRecvCompleteHandler;

void TcpOffloadRecvCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Paramètres

[in] ProtocolBindingContext

Handle à une zone de contexte allouée par le pilote de protocole. Le pilote conserve les informations de contexte par liaison dans cette zone de contexte. Le pilote a fourni ce handle à NDIS quand le pilote a appelé la fonction NdisOpenAdapterEx .

[in] NetBufferList

Pointeur vers une structure NET_BUFFER_LIST . Cette structure peut être autonome ou la première structure d’une liste liée de structures NET_BUFFER_LIST. Le pilote a fourni ce pointeur en tant que paramètre d’entrée dans un appel précédent à NdisOffloadTcpReceive , fonction.

Valeur de retour

None

Remarques

En réponse à l’appel d’un pilote ou d’une cible de déchargement sous-jacent à NdisOffloadTcpReceiveComplete , NDIS appelle la fonction ProtocolTcpOffloadReceiveComplete du pilote de protocole de sur-superposition ou du pilote intermédiaire.

Pour propager l’achèvement de l’opération d’E/S au pilote de dépassement, le pilote intermédiaire lui-même appelle la fonction NdisOffloadTcpReceiveComplete , en passant les éléments suivants :

ProtocoleBindingContext, qui est un handle qui identifie de manière unique le pilote intermédiaire.
Le pointeur PNET_BUFFER_LIST que NDIS a transmis à la fonction ProtocolTcpOffloadReceiveComplete du pilote intermédiaire.

En réponse, NDIS appelle la fonction ProtocolTcpOffloadReceiveComplete du pilote overlying, en passant un handle ProtocolBindingContext et le pointeur PNET_BUFFER_LIST fourni par le pilote intermédiaire à la fonction NdisOffloadTcpReceiveComplete .