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 de retour
Retourne l’adresse de la routine dont le nom est spécifié à 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 compatible vers l’arrière. 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 se charge toujours sur le système d’exploitation.
Aucune amélioration des performances n’est obtenue à l’aide de l’adresse retournée par NdisGetRoutineAddress au lieu d’appeler la routine spécifiée par nom. Par conséquent, n’écrivez pas de pilote NDIS pour utiliser NdisGetRoutineAddress si vous savez que la version NDIS avec laquelle le pilote exécutera l’exportation de la routine spécifiée.
En règle générale, un pilote NDIS appelle NdisGetRoutineAddress dans sa routine DriverEntry.