NdisIMGetDeviceContext, fonction (ndis.h)
Remarque NDIS 5. x a été déconseillé 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. pilotes x vers NDIS 6. x, consultez Portage des pilotes NDIS 5.x vers NDIS 6.0.
Cette fonction permet à une fonction miniportInitialize du pilote intermédiaire NDIS d’accéder à la zone de contexte de l’appareil 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 pour MiniportInitialize.
Valeur de retour
Le tableau suivant présente 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. |
| ZÉRO | Si la fonction ProtocolBindAdapter du pilote n’allouait pas de zone de contexte de périphérique de ce type. |
Remarques
Un pilote intermédiaire NDIS MiniportInitialize fonction appelle NdisIMGetDeviceContext pour accéder à la zone de contexte de l’appareil 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, ce qui entraîne l’appel de la fonction MiniportInitialize Du pilote. Toutefois, un pilote intermédiaire n’est pas nécessaire pour avoir une telle zone de contexte.
Lors du 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 utile pour rester des protocoles de niveau supérieur qui se lient par la suite à sa carte réseau virtuelle.
Par la suite, les protocoles NDIS de niveau supérieur liés à la même carte réseau virtuelle peuvent 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ndis.h |
| bibliothèque | Ndis.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |