NdisGetRoutineAddress-Funktion (ndis.h)

Die NdisGetRoutineAddress-Funktion gibt die Adresse einer Routine mit dem Namen der Routine zurück.

Syntax

PVOID NdisGetRoutineAddress(
  [in] PNDIS_STRING NdisRoutineName
);

Parameter

[in] NdisRoutineName

Ein Zeiger auf eine UNICODE_STRING-Struktur , die die Zeichenfolge angibt, die den Namen einer Routine enthält.

Rückgabewert

Gibt die Adresse der Routine zurück, deren Name unter NdisRoutineName angegeben ist, wenn die Routine verfügbar ist. andernfalls NULL.

Hinweise

Ein NDIS-Treiber kann NdisGetRoutineAddress verwenden, um die Adresse einer exportierten NDIS-Routine abzurufen. Der Treiber kann dann diese Adresse verwenden, um die NDIS-Routine aufzurufen.

Ein NDIS-Treiber kann NdisGetRoutineAddress verwenden, wenn der Treiber abwärtskompatibel bleiben muss. Wenn ein solcher Treiber beispielsweise eine NDIS-Routine importiert, die nicht von der derzeit ausgeführten NDIS-Version exportiert wird, lädt der E/A-Manager den Treiber nicht auf dem Betriebssystem. Der Treiber kann jedoch zuerst NdisGetRoutineAddress verwenden, um zu bestimmen, ob die Routine in der derzeit ausgeführten NDIS-Version verfügbar ist. Falls verfügbar, wird die Adresse der Routine zurückgegeben. Der Treiber kann dann die Adresse verwenden, um die Routine aufzurufen. Wenn nicht verfügbar, wird NULL zurückgegeben. Der Treiber kann die Routine nicht aufrufen, aber der Treiber wird weiterhin auf dem Betriebssystem geladen.

Es wird keine Leistungsverbesserung erzielt, indem die von NdisGetRoutineAddress zurückgegebene Adresse verwendet wird, anstatt die angegebene Routine anhand des Namens aufzurufen. Schreiben Sie daher keinen NDIS-Treiber, um NdisGetRoutineAddress zu verwenden, wenn Sie wissen, dass die NDIS-Version, mit der der Treiber ausgeführt wird, die angegebene Routine exportiert.

In der Regel ruft ein NDIS-Treiber NdisGetRoutineAddress in seiner DriverEntry-Routine auf.

Anforderungen

Weitere Informationen

DriverEntry

UNICODE_STRING