QUERY_OFFLOAD_COMPLETE_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.]
NDIS appelle la fonction ProtocolQueryOffloadComplete d’un pilote de protocole ou d’un pilote intermédiaire pour effectuer une opération de déchargement de requête que le pilote a précédemment lancée en appelant la fonction NdisQueryOffload .
Syntaxe
QUERY_OFFLOAD_COMPLETE_HANDLER QueryOffloadCompleteHandler;
void QueryOffloadCompleteHandler(
[in] IN NDIS_HANDLE ProtocolBindingContext,
[in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}
Paramètres
[in] ProtocolBindingContext
Handle à une zone de contexte allouée par le pilote de protocole. Le pilote conserve les informations de contexte par liaison dans cette zone de contexte. Le pilote a fourni ce handle à NDIS quand le pilote a appelé la fonction NdisOpenAdapterEx .
[in] OffloadBlockList
Pointeur vers un NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST structure qui peut être une structure autonome ou la racine d’une liste liée de ces structures. Ces structures identifient l’état qui a été interrogé ou qui a été tenté d’être interrogé.
Valeur de retour
None
Remarques
En réponse à l’appel d’une cible de déchargement sous-jacente ou d’un pilote intermédiaire au NdisMQueryOffloadStateComplete , NDIS appelle la fonction ProtocolQueryOffloadComplete du pilote de protocole de sur-superposition ou du pilote intermédiaire.
Un pilote intermédiaire doit propager l’achèvement de l’opération de déchargement de requête au pilote situé au-dessus en appelant NdisMQueryOffloadStateComplete. Pour plus d'informations, consultez la rubrique Propagation de l’achèvement d’une opération de State-Manipulation.
À partir de la structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST qui a été passée à sa fonction ProtocolQueryOffloadComplete , le pilote intermédiaire construit un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure. Pour plus d’informations, consultez Réutilisation d’une structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Lors de l’appel de la fonction NdisMQueryOffloadStateComplete , le pilote intermédiaire transmet un pointeur (le paramètre OffloadBlockList ) à cette structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST nouvellement construite.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ndischimney.h (inclure Ndischimney.h) |