TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER fonction de rappel (ndischimney.h)

Article
02/29/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 ProtocolTcpOffloadForwardComplete d’un protocole ou d’un pilote intermédiaire pour effectuer une opération de transfert que le pilote a précédemment initiée en appelant le NdisOffloadTcpForward , fonction.

Syntaxe

TCP_OFFLOAD_FORWARD_COMPLETE_HANDLER TcpOffloadForwardCompleteHandler;

void TcpOffloadForwardCompleteHandler(
  [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 à la fonction NdisOffloadTcpForward .

Valeur de retour

None

Remarques

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

Pour propager l’achèvement de l’opération de transfert à la pile d’hôtes ou de pilotes qui se superposent, le pilote intermédiaire appelle la fonction NdisOffloadTcpForwardComplete , 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 ProtocolTcpOffloadForwardComplete du pilote intermédiaire.

En réponse, NDIS appelle la fonction ProtocolTcpOffloadForwardComplete du pilote ou de la pile hôte de sur-superposition, en passant un handle ProtocolBindingContext et le pointeur PNET_BUFFER_LIST fourni par le pilote intermédiaire à la fonction NdisOffloadTcpForwardComplete .