W_UPDATE_OFFLOAD_HANDLER fonction de rappel (ndischimney.h)

Article
08/07/2023

[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 par 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] 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

None

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 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 le Fonction NdisMUpdateOffloadComplete .

Avant le retour de la fonction MiniportUpdateOffload , la cible de déchargement utilise l’arborescence d’état de déchargement passée à la fonction MiniportUpdateOffload pour mettre à jour l’état déchargé :

La cible de déchargement copie les valeurs de variable de n’importe quelle structure 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 de chemin d’accès au voisin 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.