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 les objets d’état de cheminée TCP précédemment 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 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, 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
None
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 façon 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 être retourné à partir de la fonction MiniportQueryOffload , le pilote miniport remplit la structure d’état de déchargement qui est 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 dans la structure.
Avant d’appeler la fonction NdisMQueryOffloadStateComplete , la cible de déchargement doit écrire l’une des valeurs NDIS_STATUS suivantes dans le membre Status de chaque structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST dans l’arborescence d’état :
-
NDIS_STATUS_SUCCESS
La cible de déchargement a correctement interrogé 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ndischimney.h (inclure Ndischimney.h) |
| IRQL | N’importe quel niveau |