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

Voir aussi

NdisOpenAdapterEx

ProtocolBindAdapterEx