NdisReEnumerateProtocolBindings, fonction (ndis.h)
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) |