Funzione NdisGetRoutineAddress (ndis.h)
La funzione NdisGetRoutineAddress restituisce l'indirizzo di una routine in base al nome della routine.
Sintassi
PVOID NdisGetRoutineAddress(
[in] PNDIS_STRING NdisRoutineName
);
Parametri
[in] NdisRoutineName
Puntatore a una struttura UNICODE_STRING che specifica la stringa contenente il nome di una routine.
Valore restituito
Restituisce l'indirizzo della routine il cui nome è specificato in NdisRoutineName se la routine è disponibile; in caso contrario, NULL.
Osservazioni
Un driver NDIS può usare NdisGetRoutineAddress per ottenere l'indirizzo di una routine NDIS esportata. Il driver può quindi usare questo indirizzo per chiamare la routine NDIS.
Un driver NDIS può usare NdisGetRoutineAddress se il driver deve rimanere compatibile con le versioni precedenti. Ad esempio, se un driver di questo tipo importa una routine NDIS che non viene esportata dalla versione di NDIS attualmente in esecuzione, gestione I/O non caricherà il driver nel sistema operativo. Tuttavia, il driver può usare prima NdisGetRoutineAddress per determinare se la routine è disponibile nella versione di NDIS attualmente in esecuzione. Se disponibile, viene restituito l'indirizzo della routine. Il driver può quindi usare l'indirizzo per chiamare la routine. Se non è disponibile, viene restituito NULL. Il driver non può chiamare la routine, ma il driver viene ancora caricato nel sistema operativo.
Non viene ottenuto alcun miglioramento delle prestazioni usando l'indirizzo restituito da NdisGetRoutineAddress anziché chiamare la routine specificata in base al nome. Pertanto, non scrivere un driver NDIS per usare NdisGetRoutineAddress se si sa che la versione NDIS con cui verrà eseguito il driver esporta la routine specificata.
In genere, un driver NDIS chiama NdisGetRoutineAddress nella routine DriverEntry.