NdisGetRoutineAddress, fonction (ndis.h)
La fonction NdisGetRoutineAddress retourne l’adresse d’une routine en fonction du nom de la routine.
Syntaxe
PVOID NdisGetRoutineAddress(
[in] PNDIS_STRING NdisRoutineName
);
Paramètres
[in] NdisRoutineName
Pointeur vers une structure UNICODE_STRING qui spécifie la chaîne qui contient le nom d’une routine.
Valeur retournée
Retourne l’adresse de la routine dont le nom est spécifié dans NdisRoutineName si la routine est disponible ; sinon, NULL.
Remarques
Un pilote NDIS peut utiliser NdisGetRoutineAddress pour obtenir l’adresse d’une routine NDIS exportée. Le pilote peut ensuite utiliser cette adresse pour appeler la routine NDIS.
Un pilote NDIS peut utiliser NdisGetRoutineAddress si le pilote doit rester à compatibilité descendante. Par exemple, si un tel pilote importe une routine NDIS qui n’est pas exportée par la version de NDIS en cours d’exécution, le gestionnaire d’E/S ne charge pas le pilote sur le système d’exploitation. Toutefois, le pilote peut d’abord utiliser NdisGetRoutineAddress pour déterminer si la routine est disponible dans la version de NDIS en cours d’exécution. Si elle est disponible, l’adresse de la routine est retournée. Le pilote peut ensuite utiliser l’adresse pour appeler la routine. S’il n’est pas disponible, null est retourné. Le pilote ne peut pas appeler la routine, mais le pilote charge toujours sur le système d’exploitation.
Aucune amélioration des performances n’est obtenue en utilisant l’adresse retournée par NdisGetRoutineAddress au lieu d’appeler la routine spécifiée par son nom. Par conséquent, n’écrivez pas de pilote NDIS pour utiliser NdisGetRoutineAddress si vous savez que la version de NDIS avec laquelle le pilote s’exécutera exporte la routine spécifiée.
En règle générale, un pilote NDIS appelle NdisGetRoutineAddress dans sa routine DriverEntry .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisGetRoutineAddress (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisGetRoutineAddress (NDIS 5.1)) dans Windows XP. |
| Plateforme cible | Universal |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | Irql_Miscellaneous_Function(ndis) |