Partager via


NdisIMGetBindingContext, fonction (ndis.h)

La fonction NdisIMGetBindingContext permet à un pilote de protocole NDIS d’accéder à la zone de contexte de périphérique, qui a été 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 retourné par la fonction NdisOpenAdapterEx au paramètre NdisBindingHandle qui identifie la miniport virtuelle du pilote intermédiaire inférieur suivant auquel l’appelant est lié.

Valeur retournée

NdisIMGetBindingContext retourne un handle à la zone de contexte de l’appareil pour le miniport virtuel donné, ou retourne NULL si aucune zone de contexte de ce type 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 d’appareil 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 qui sont liés au même pilote intermédiaire sous-jacent.

Cette zone de contexte d’appareil a été allouée et définie par le pilote intermédiaire NDIS de niveau inférieur et passée à NDIS lors d’un appel à 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 préservant l’état configuré par le pilote intermédiaire NDIS sous-jacent qui l’a définie.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisIMGetBindingContext (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisIMGetBindingContext (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 < DISPATCH_LEVEL
Règles de conformité DDI Irql_IM_Function(ndis)

Voir aussi

NdisIMInitializeDeviceInstanceEx

NdisOpenAdapterEx

ProtocolBindAdapterEx