W_UPDATE_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 MiniportUpdateOffload met à jour les objets d’état de cheminée TCP précédemment déchargés.
Syntaxe
W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;
void WUpdateOffloadHandler(
[in] IN NDIS_HANDLE MiniportAdapterContext,
[in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}
Paramètres
[in] MiniportAdapterContext
Handle vers une zone de contexte allouée à 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 lors de son appel NdisMSetMiniportAttributes à partir de son fonction MiniportInitializeEx.
[in] 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 en cours de mise à jour. Seules les variables mises en cache sont mises à jour.
Valeur de retour
Aucun
Remarques
Seules les variables mises en cache sont mises à jour.
La fonction MiniportUpdateOffload stocke le handle MiniportAdapterContext et le pointeur OffloadBlockList, puis retourne. La cible de déchargement termine toujours l’opération de mise à jour de façon asynchrone en appelant le fonction NdisMUpdateOffloadComplete. 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 le fonction NdisMUpdateOffloadComplete.
Avant le retour de la fonction MiniportUpdateOffload, la cible de déchargement utilise l’arborescence d’état de déchargement transmise à la fonction MiniportUpdateOffload pour mettre à jour l’état déchargé :
- La cible de déchargement copie les valeurs des variables de toutes les structures d’état de l’arborescence vers les objets d’état déchargés correspondants. Seules les variables CACHED sont mises à jour.
- L’arborescence peut indiquer que les liens path-to-neighbor doivent être mis à jour. Pour plus d’informations, consultez liaison d’objets d’état de chemin d’accès à un nouvel objet d’état voisin. Dans ce cas, la cible de déchargement doit mettre à jour sa représentation interne de l’état déchargé pour refléter les liens mis à jour.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | ndischimney.h (include Ndischimney.h) |
| IRQL | N’importe quel niveau |