NdisIMGetDeviceContext, fonction (ndis.h)

  • Article

Note NDIS 5. x a été déprécié et est remplacé par NDIS 6. x. Pour le développement de nouveaux pilotes NDIS, consultez Pilotes réseau à partir de Windows Vista. Pour plus d’informations sur le portage de NDIS 5. x pilotes vers NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.

Cette fonction permet à la fonction MiniportInitialize d’un pilote intermédiaire NDIS d’accéder à la zone de contexte de périphérique allouée par sa fonction ProtocolBindAdapter .

Syntaxe

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Paramètres

[in] MiniportAdapterHandle

Spécifie l’entrée de handle dans MiniportInitialize.

Valeur retournée

Le tableau suivant montre les valeurs de retour pour cette fonction.

Valeur Description
NDISIMGETDEVICECONTEXT Retourne l’accès à la zone de contexte de l’appareil pour la carte réseau virtuelle identifiée par MiniportAdapterHandle.
NULL Si la fonction ProtocolBindAdapter du pilote n’a pas alloué une telle zone de contexte de périphérique.

Remarques

La fonction MiniportInitialize d’un pilote intermédiaire NDIS appelle NdisIMGetDeviceContext pour accéder à la zone de contexte de périphérique pour la carte réseau virtuelle qu’il initialise. En règle générale, la mémoire d’une telle zone est fournie par la fonction ProtocolBindAdapter du pilote intermédiaire, qui appelle NdisIMInitializeDeviceInstanceEx avec un pointeur vers cette zone, provoquant ainsi l’appel de la fonction MiniportInitialize du pilote. Toutefois, un pilote intermédiaire n’est pas obligé d’avoir une telle zone de contexte.

Au retour de NdisIMGetDeviceContext, MiniportInitialize configure l’état défini par le pilote pour la carte réseau virtuelle avec les informations que l’enregistreur de pilotes intermédiaires a l’intention d’être utiles pour les protocoles de niveau supérieur qui se lient par la suite à sa carte réseau virtuelle.

Les protocoles NDIS de niveau supérieur liés à la même carte réseau virtuelle peuvent ensuite accéder à cette zone de contexte d’appareil en appelant NdisIMGetBindingContext à partir de leurs fonctions ProtocolBindAdapter .

Versions du système d’exploitation : Windows CE .NET 4.0 et versions ultérieures.

Configuration requise

Condition requise Valeur
En-tête ndis.h
Bibliothèque Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

Voir aussi