TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER fonction de rappel (ndischimney.h)
[La fonctionnalité de déchargement de cheminée TCP est déconseillée et ne doit pas être utilisée.]
NDIS appelle la fonction ProtocolTcpOffloadDisconnectComplete d’un pilote de protocole ou intermédiaire pour terminer une opération de déconnexion que le pilote a lancée précédemment en appelant la fonction fonction NdisOffloadTcpDisconnect.
Syntaxe
TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;
void TcpOffloadDisconnectCompleteHandler(
[in] IN NDIS_HANDLE ProtocolBindingContext,
[in] IN PNET_BUFFER_LIST NetBufferList
)
{...}
Paramètres
[in] ProtocolBindingContext
Handle vers une zone de contexte allouée par le pilote de protocole. Le pilote gère les informations de contexte par liaison dans cette zone de contexte. Le pilote a fourni ce handle à NDIS lorsque le pilote a appelé la fonction NdisOpenAdapterEx.
[in] NetBufferList
Lorsqu’il n’est pas NULL, pointeur vers une structure de NET_BUFFER_LIST unique. Le pilote a fourni ce pointeur en tant que paramètre d’entrée dans un appel précédent au fonction NdisOffloadTcpDisconnect.
Valeur de retour
Aucun
Remarques
En réponse à l’appel d’un pilote sous-jacent ou du déchargement de l’appel de la cible à l’adresse fonction NdisTcpOffloadDisconnectComplete, NDIS appelle la fonction ProtocolTcpOffloadDisconnectComplete du pilote de protocole ou du pilote intermédiaire.
Pour propager l’achèvement de l’opération de déconnexion au pilote surchargé, le pilote intermédiaire appelle la fonction NdisOffloadTcpDisconnectComplete, en passant les éléments suivants :
- Un ProtocolBindingContext, qui est un handle qui identifie de manière unique le pilote intermédiaire.
- Le même pointeur PNET_BUFFER_LIST que NDIS a passé à la fonction ProtocolTcpOffloadDisconnectComplete du pilote intermédiaire.
Avant de retourner, la fonction ProtocolTcpOffloadDisconnectComplete doit libérer la mémoire pour tout contexte qu’elle a créé pour la structure NET_BUFFER_LIST passée à la fonction.
Notez que, si un pilote intermédiaire exporte plusieurs interfaces vers des protocoles trop longs, il doit déterminer quel protocole doit recevoir l’achèvement de la déconnexion. Pour effectuer cette détermination, le pilote intermédiaire utilise des informations qu’il a stockées dans le NET_BUFFER_LIST_CONTEXT structure, associée à la structure NET_BUFFER_LIST.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | ndischimney.h (include Ndischimney.h) |