TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER fonction de rappel (ndischimney.h)

Article
02/26/2024

[La fonctionnalité de déchargement de la 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 d’un pilote intermédiaire pour effectuer une opération de déconnexion lancée précédemment par le pilote en appelant le 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 à 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 lorsque le pilote a appelé la fonction NdisOpenAdapterEx .

[in] NetBufferList

Si la valeur n’est pas NULL, un pointeur vers une structure 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

None

Remarques

En réponse à l’appel d’un pilote ou d’une cible de déchargement sous-jacent à 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 de suralimentation, le pilote intermédiaire appelle la fonction NdisOffloadTcpDisconnectComplete , en passant les éléments suivants :

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

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

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 interface 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 les informations qu’il a stockées dans le NET_BUFFER_LIST_CONTEXT structure, qui est associée à la structure NET_BUFFER_LIST.