W_TERMINATE_OFFLOAD_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.]
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 vers une zone de contexte allouée à une 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 lors de son 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 ces structures. Ces structures identifient les objets d’état déchargés qui sont arrêtés.
Valeur de retour
Aucun
Remarques
La fonction MiniportTerminateOffload stocke le pointeur OffloadBlockList, puis retourne. La cible de déchargement termine toujours l’opération d’arrêt de façon 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 racines 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 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 par une structure d’état déléguée (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ées 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 requêtes en attente d’invalidation, de requête 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | ndischimney.h (include Ndischimney.h) |
| IRQL | N’importe quel niveau |