NdisMOffloadEventIndicate, fonction (ndischimney.h)

Article
02/07/2025

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

Une cible de déchargement appelle la fonction NdisMOffloadEventIndicate pour indiquer différents événements à la pile hôte.

Syntaxe

void NdisMOffloadEventIndicate(
  [in] IN NDIS_HANDLE                       NdisMiniportHandle,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList,
  [in] IN ULONG                             IndicationCode
);

Paramètres

[in] NdisMiniportHandle

Handle que la cible de déchargement obtenue dans un appel précédent à NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Pointeur vers un structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Cette structure identifie l’objet d’état déchargé sur lequel l’indication est effectuée. Notez qu’il n’existe qu’une seule structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Il n’existe pas de liste liée de ces structures.

La cible de déchargement fournit un pointeur OffloadBlockList valide lors de la création d’une indication NeighborReachabilityQuery. Dans ce cas, la cible de déchargement fournit un structure NEIGHBOR_OFFLOAD_STATE_CONST, a NEIGHBOR_OFFLOAD_STATE_CACHED structure et a NEIGHBOR_OFFLOAD_STATE_DELEGATED structure (dans cet ordre) immédiatement après la structure de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST référencée par le pointeur OffloadBlockList.

Une cible de déchargement doit initialiser les membres suivants d’une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST qu’elle transmet à la fonction NdisMOffloadEventIndicate :

Tous les membres de la structure NDIS_OBJECT_HEADER, y compris Type, Révisionet Taille . La cible de déchargement doit initialiser type pour NeighborOffloadState.
Le pointeur NextBlock vers une valeurNULL non s’il existe un bloc suivant ; sinon, pour NULL .
Pointeur DependentBlockList vers NULL.
Membre Status à NDIS_STATUS_SUCCESS.

La cible de déchargement n’a pas besoin d’initialiser d’autres membres de la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.

Pour toutes les indications autres que l’indication NeighborReachabilityQuery, la cible de déchargement fournit un pointeur OffloadBlockListNULL.

[in] IndicationCode

L’événement indiqué est spécifié comme l’une des valeurs de INDICATE_OFFLOAD_EVENT suivantes :

NeighborReachabilityQuery

Indique qu’une entrée de cache voisin (NCE) est devenue obsolète. Pour plus d’informations sur les ncEs, consultez RFC 2461.

NeighborReachabilityInDoubt

Réservé.

Valeur de retour

Aucun

Remarques

La pile hôte utilise l’indication NeighborReachabilityQuery pour détecter l’inachabilité des voisins pour IPv4 et IPv6. Pour obtenir une description détaillée de cette indication, consultez Making a NeighborReachabilityQuery Indication.