NdisReEnumerateProtocolBindings, fonction (ndis.h)
La fonction NdisReEnumerateProtocolBindings permet à NDIS d’appeler la fonction ProtocolBindAdapterEx d’un pilote de protocole fonction une fois pour chaque adaptateur miniport pour lequel le pilote est configuré pour 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 au fonction NdisRegisterProtocolDriver.
Valeur de retour
Aucun
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 ProtocolBindAdapterEx, ou fonctions ProtocolUnbindAdapterEx. En outre, les pilotes de protocole ne peuvent pas appeler NdisReEnumerateProtocolBindings à partir du contexte de la fonction ProtocolNetPnPEvent si la fonction
paramètre protocolBindingContext de ProtocolNetPnPEvent n’est pas NULL. Toutefois, les pilotes de protocole peuvent appeler NdisReEnumerateProtocolBindings à partir du contexte de ProtocolNetPnPEvent si ProtocolBindingContext est NULL. Une valeur NULLProtocolBindingContext indique que l’événement s’applique à toutes les liaisons.
NDIS peut terminer les opérations de liaison après l’appel à NdisReEnumerateProtocolBindings retourne. Autrement dit, NDIS peut terminer les liaisons aux adaptateurs miniport pour lesquels le pilote de protocole est configuré pour lier, mais auquel le pilote de protocole n’est pas actuellement lié ultérieurement.
Un pilote intermédiaire doit appeler NdisReEnumerateProtocolBindings après sa fonction ProtocolNetPnPEvent reçoit NetEventReconfigure sur un NULLProtocolBindingContext. NDIS appelle ensuite la fonction ProtocolBindAdapterEx du pilote fonction une fois pour chaque adaptateur miniport pour lequel le pilote est configuré pour lier, mais auquel le pilote n’est pas actuellement lié.
Exigences
Exigence | Valeur |
---|---|
client minimum 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 (voir NdisReEnumerateProtocolBindings (NDIS 5.1)) dans Windows XP. |
plateforme cible | Bureau |
d’en-tête | ndis.h (include Ndis.h) |
bibliothèque | Ndis.lib |
IRQL | PASSIVE_LEVEL |
règles de conformité DDI | Irql_Miscellaneous_Function(ndis), NdisReEnumerateProtocolBindings(ndis) |