W_QUERY_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 MiniportQueryOffload interroge précédemment les objets d’état de cheminée TCP déchargés.
Syntaxe
W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;
void WQueryOffloadHandler(
[in] IN NDIS_HANDLE MiniportAdapterContext,
[in, out] IN OUT 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, out] 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’état déchargé qui est interrogé.
Valeur de retour
Aucun
Remarques
La fonction MiniportQueryOffload peut interroger n’importe quel état de cheminée TCP qui a été déchargé sur la cible de déchargement.
La fonction MiniportQueryOffload stocke le pointeur OffloadBlockList, puis retourne. La cible de déchargement termine toujours l’opération de requête de manière asynchrone en appelant le fonction NdisMQueryOffloadStateComplete. Le pointeur OffloadBlockList pointe vers un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure qui peut être une structure autonome ou le nœud racine dans une arborescence d’état de déchargement . L’arborescence d’état est valide jusqu’à ce que la cible de déchargement appelle la fonction NdisMQueryOffloadStateComplete.
Après le retour de la fonction MiniportQueryOffload, le pilote miniport remplit la structure d’état de déchargement associée à chaque structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dans l’arborescence d’état pointée par le pointeur OffloadBlockList. Dans chacune de ces structures d’état de déchargement, le pilote miniport écrit la valeur actuelle de chaque variable de la structure.
Avant d’appeler la fonction NdisMQueryOffloadStateComplete, la cible de déchargement doit écrire l’une des valeurs de NDIS_STATUS suivantes dans l'Status membre de chaque structure de NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dans l’arborescence d’état :
-
NDIS_STATUS_SUCCESS
La cible de déchargement a interrogé correctement les objets d’état.
-
NDIS_STATUS_FAILURE
L’opération de requête n’a pas réussi. La pile hôte met fin aux objets d’état qui n’ont pas pu être interrogés.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | ndischimney.h (include Ndischimney.h) |
| IRQL | N’importe quel niveau |