NdisIMGetBindingContext, fonction (ndis.h)
La fonction NdisIMGetBindingContext permet à un pilote de protocole NDIS d’accéder à la zone de contexte de périphérique, créée par un pilote intermédiaire sous-jacent, pour un miniport virtuel auquel le pilote de protocole de niveau supérieur est lié.
Syntaxe
NDIS_HANDLE NdisIMGetBindingContext(
[in] NDIS_HANDLE NdisBindingHandle
);
Paramètres
[in] NdisBindingHandle
Handle de liaison que la fonction NdisOpenAdapterEx retournée au paramètre NdisBindingHandle qui identifie le miniport virtuel du pilote intermédiaire inférieur suivant auquel l’appelant est lié.
Valeur de retour
NdisIMGetBindingContext retourne un handle à la zone de contexte de l’appareil pour le miniport virtuel donné, ou retourne NULL si aucune zone de contexte n’existe.
Remarques
Un pilote de protocole ou un pilote intermédiaire peut appeler NdisIMGetBindingContext à partir de sa fonction ProtocolBindAdapterEx pour accéder au contexte de périphérique d’un miniport virtuel auquel il est lié. Le contexte de l’appareil fournit une zone de contexte commune pour tous les pilotes de protocole overlying liés au même pilote intermédiaire sous-jacent.
Une telle zone de contexte d’appareil a été allouée et définie par le pilote intermédiaire NDIS de niveau inférieur et transmise à NDIS dans un appel au fonction NdisIMInitializeDeviceInstanceEx.
Tous les pilotes de protocole qui appellent NdisIMGetBindingContext peuvent supposer en toute sécurité que le pilote intermédiaire sous-jacent a alloué sa zone de contexte à partir d’un pool non paginé. Ils doivent traiter la zone de contexte retournée en lecture seule, en conservant l’état configuré par le pilote intermédiaire NDIS sous-jacent qui l’a défini.