W_INVALIDATE_OFFLOAD_HANDLER fonction de rappel (ndischimney.h)

  • Article

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

La fonction MiniportInvalidateOffload invalide les objets d’état de cheminée TCP précédemment déchargés.

Syntaxe

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [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 de la cible de déchargement dans laquelle la cible de déchargement conserve des 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 l’objet d’état déchargé qui est en cours d’invalidation.

Valeur de retour

None

Remarques

La fonction MiniportInvalidateOffload stocke le pointeur OffloadBlockList , puis retourne. La cible de déchargement termine toujours l’opération d’invalidation de façon asynchrone en appelant NdisMInvalidateOffloadComplete.

L’arborescence passée à la fonction MiniportInvalidateOffload contient uniquement NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structures. L’arborescence ne contient aucune structure d’état de déchargement. Autrement dit, il n’existe aucune structure de ce type qui suit les structures NDIS_MINIPORT_OFFLOAD_BLOCK_LIST en mémoire.

Les structures NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dans l’arborescence indiquent que l’objet d’état doit être invalidé. Un membre *MiniportOffloadContext non NULL pointe vers un emplacement de mémoire contenant une valeur PVOID qui a été fournie par la cible de déchargement lors du déchargement de l’objet state. Pour plus d’informations, consultez Stockage et référencement de l’état déchargé. Cette valeur PVOID fait référence au contexte de déchargement miniport dans lequel la cible de déchargement stocke l’objet d’état à invalider.

Pour plus d’informations sur le traitement par une cible de déchargement des objets à état invalidés, consultez Traitement des objets d’état invalidés.

Finalement, la pile hôte met fin au déchargement de l’objet d’état invalidé. Toutefois, jusqu’à ce moment, la cible de déchargement possède l’objet d’état invalidé. La cible de déchargement ne doit pas libérer les ressources de l’objet d’état invalidé tant que la pile hôte n’a pas terminé le déchargement de cet objet d’état. La cible de déchargement ne doit pas utiliser l’objet d’état invalidé ou les connexions TCP qui dépendent de cet objet d’état pour l’envoi de données.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête ndischimney.h (inclure Ndischimney.h)
IRQL N’importe quel niveau

Voir aussi

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes