W_TERMINATE_OFFLOAD_HANDLER fonction de rappel (ndischimney.h)

Article
02/29/2024

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

La fonction MiniportTerminateOffload met fin au déchargement d’un ou plusieurs objets d’état.

Syntaxe

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Paramètres

[in] MiniportAdapterContext

Handle dans une zone de contexte allouée de la cible de déchargement dans laquelle la cible de déchargement conserve les informations d’état sur cette instance de l’adaptateur. La cible de déchargement a fourni ce handle à NDIS lorsqu’elle a appelé NdisMSetMiniportAttributes à partir de son Fonction MiniportInitializeEx .

[in, out] OffloadBlockList

Pointeur vers un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure, qui peut être la racine d’une liste liée de telles structures. Ces structures identifient les objets d’état déchargés qui se terminent.

Valeur de retour

None

Remarques

La fonction MiniportTerminateOffload stocke le pointeur OffloadBlockList , puis retourne. La cible de déchargement termine toujours l’opération d’arrêt de manière asynchrone en appelant le Fonction NdisMTerminateOffloadComplete .

Le pointeur OffloadBlockList pointe vers une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST qui peut être une structure autonome ou la liste de blocs racine dans une arborescence d’état de déchargement qui contient plusieurs structures NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Ces listes de blocs, ainsi que toutes les structures d’état de déchargement qui leur sont associées, sont valides jusqu’à ce que le pilote miniport appelle la fonction NdisMTerminateOffloadComplete .

Chaque structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST peut être immédiatement suivie en mémoire d’une structure d’état délégué (XXX_OFFLOAD_STATE_DELEGATED). La cible de déchargement copie les valeurs de variable déléguées dans les structures d’état délégué fournies par la pile hôte.

La pile hôte ne demande pas l’arrêt du déchargement d’une connexion TCP tant que les deux conditions suivantes ne sont pas remplies :

Toutes les demandes d’invalidation, d’interrogation et de mise à jour relatives à cette connexion sont terminées.
Tous les appels de réception et de déconnexion en attente sont retournés.