NdisReEnumerateProtocolBindings, fonction (ndis.h)

Article
02/26/2024

La fonction NdisReEnumerateProtocolBindings permet à NDIS d’appeler la fonction ProtocolBindAdapterEx d’un pilote de protocole une fois pour chaque adaptateur miniport pour lequel le pilote est configuré pour se lier, mais auquel le pilote n’est pas actuellement lié.

Syntaxe

void NdisReEnumerateProtocolBindings(
  [in] NDIS_HANDLE NdisProtocolHandle
);

Paramètres

[in] NdisProtocolHandle

Handle représentant le pilote de protocole appelant. Le pilote a obtenu ce handle avec un appel précédent à Fonction NdisRegisterProtocolDriver .

Valeur de retour

None

Remarques

Un pilote de protocole peut appeler la fonction NdisReEnumerateProtocolBindings pour se connecter à un ou plusieurs adaptateurs miniport.

Les pilotes de protocole ne peuvent pas appeler NdisReEnumerateProtocolBindings à partir du contexte du ProtocoleBindAdapterEx, ou Fonctions ProtocolUnbindAdapterEx . En outre, les pilotes de protocole ne peuvent pas appeler NdisReEnumerateProtocolBindings à partir du contexte de la fonction ProtocolNetPnPEvent si
Le paramètre ProtocolBindingContext de ProtocolNetPnPEvent n’est pas NULL. Toutefois, les pilotes de protocole peuvent appeler NdisReEnumerateProtocolBindings à partir du contexte de ProtocolNetPnPEvent si ProtocolBindingContext a la valeur NULL. Une valeur NULL ProtocolBindingContext indique que l’événement s’applique à toutes les liaisons.

NDIS peut terminer les opérations de liaison après le retour de l’appel à NdisReEnumerateProtocolBindings . Autrement dit, NDIS peut effectuer des liaisons aux adaptateurs miniport pour lesquels le pilote de protocole est configuré pour la liaison, mais auxquels le pilote de protocole n’est actuellement pas lié ultérieurement.

Un pilote intermédiaire doit appeler NdisReEnumerateProtocolBindings après que sa fonction ProtocolNetPnPEvent a reçu NetEventReconfigure sur un protocole NULLBindingContext . NDIS appelle ensuite la fonction ProtocolBindAdapterEx du pilote une fois pour chaque carte miniport pour laquelle le pilote est configuré pour se lier, mais à laquelle le pilote n’est actuellement pas lié.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisReEnumerateProtocolBindings (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisReEnumerateProtocolBindings (NDIS 5.1)) dans Windows XP.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis),NdisReEnumerateProtocolBindings(ndis)