NdisMOffloadEventIndicate, fonction (ndischimney.h)

Article
03/05/2024

[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 auquel la cible de déchargement a obtenu lors d’un appel précédent NdisMRegisterMiniportDriver.

[in] OffloadBlockList

Pointeur vers un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure. 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 l’établissement d’une indication NeighborReachabilityQuery . Dans ce cas, la cible de déchargement fournit un NEIGHBOR_OFFLOAD_STATE_CONST structure, un NEIGHBOR_OFFLOAD_STATE_CACHED structure et un NEIGHBOR_OFFLOAD_STATE_DELEGATED structure (dans cet ordre) immédiatement après la structure 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 de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST qu’elle transmet à la fonction NdisMOffloadEventIndicate :

Tous les membres de la structure NDIS_OBJECT_HEADER, y compris Type, Revision et Size . La cible de déchargement doit initialiser Type sur NeighborOffloadState.
Pointeur NextBlock vers une valeur non NULL s’il existe un bloc suivant ; sinon, à 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 OffloadBlockList qui a la valeur NULL.

[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 CNE, consultez RFC 2461.

NeighborReachabilityInDoubt

Réservé.

Valeur de retour

None

Remarques

La pile hôte utilise l’indication NeighborReachabilityQuery pour détecter l’inachabilité du voisin pour IPv4 et IPv6. Pour obtenir une description détaillée de cette indication, consultez Création d’une indication neighborReachabilityQuery.