W_INVALIDATE_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 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 à une 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 l’objet d’état déchargé qui est invalidé.
Valeur de retour
Aucun
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 transmise à la fonction MiniportInvalidateOffload contient uniquement des structures NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. L’arborescence ne contient aucune structures d’état de déchargement. Autrement dit, il n’y a pas de telles structures qui suivent 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 non NULL *MiniportOffloadContext membre pointe vers un emplacement de mémoire contenant une valeur PVOID fournie par la cible de déchargement lorsque l’objet d’état a été déchargé. 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 d’un cible de déchargement des objets d’état invalidés, consultez Traitement des objets d’état invalidés.
Finalement, la pile hôte arrêter le déchargement de l’objet d’état invalidé. Toutefois, jusqu’à ce moment-là, 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | ndischimney.h (include Ndischimney.h) |
| IRQL | N’importe quel niveau |