Funzione NdisGetRoutineAddress (ndis.h)

La funzione NdisGetRoutineAddress restituisce l'indirizzo di una routine specificata dal 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.

Commenti

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 tale driver importa una routine NDIS non esportata dalla versione di NDIS attualmente in esecuzione, la gestione I/O non caricherà il driver nel sistema operativo. Tuttavia, il driver può prima usare 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 carica ancora sul sistema operativo.

Nessun miglioramento delle prestazioni viene ottenuto 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 conosce che la versione NDIS con cui il driver eseguirà esporta la routine specificata.

In genere, un driver NDIS chiama NdisGetRoutineAddress nella routine DriverEntry .

Requisiti

Vedi anche

DriverEntry

UNICODE_STRING