NdisQueryOffloadState, fonction (ndischimney.h)

Article
03/05/2024

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

Un protocole ou un pilote intermédiaire appelle la fonction NdisQueryOffloadState pour interroger les objets d’état de cheminée TCP précédemment déchargés.

Syntaxe

void NdisQueryOffloadState(
  [in] IN NDIS_HANDLE                       NdisBindingHandle,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
);

Paramètres

[in] NdisBindingHandle

Handle fourni par NDIS au paramètre NdisBindingHandle de NdisOpenAdapterEx. Ce handle identifie la liaison entre l’appelant et le pilote intermédiaire sous-jacent ou la cible de déchargement.

[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 les objets d’état déchargés qui sont interrogés.

Valeur de retour

None

Remarques

Un pilote intermédiaire appelle la fonction NdisQueryOffloadState pour propager une opération de déchargement de requête initiée par la pile hôte. Pour plus d’informations, consultez Propagation d’opérations State-Manipulation.

À partir de la structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST passée à sa fonction MiniportQueryOffload , le pilote intermédiaire construit une structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Pour plus d’informations, consultez Réutilisation d’un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Structure. Le pilote intermédiaire transmet un pointeur (le paramètre OffloadBlockList ) à cette structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST lors de l’appel de la fonction NdisQueryOffloadState .