Función NdisGetRoutineAddress (ndis.h)
La función NdisGetRoutineAddress devuelve la dirección de una rutina dada el nombre de la rutina.
Sintaxis
PVOID NdisGetRoutineAddress(
[in] PNDIS_STRING NdisRoutineName
);
Parámetros
[in] NdisRoutineName
Puntero a una estructura UNICODE_STRING que especifica la cadena que contiene el nombre de una rutina.
Valor devuelto
Devuelve la dirección de la rutina cuyo nombre se especifica en NdisRoutineName si la rutina está disponible; De lo contrario, null.
Observaciones
Un controlador NDIS puede usar NdisGetRoutineAddress para obtener la dirección de una rutina NDIS exportada. A continuación, el controlador puede usar esta dirección para llamar a la rutina NDIS.
Un controlador NDIS puede usar NdisGetRoutineAddress si el controlador debe permanecer compatible con versiones anteriores. Por ejemplo, si este controlador importa una rutina NDIS no exportada por la versión de NDIS que se está ejecutando actualmente, el administrador de E/S no cargará el controlador en el sistema operativo. Sin embargo, el controlador puede usar primero NdisGetRoutineAddress para determinar si la rutina está disponible en la versión de NDIS que se está ejecutando actualmente. Si está disponible, se devuelve la dirección de la rutina. A continuación, el controlador puede usar la dirección para llamar a la rutina. Si no está disponible, se devuelve NULL. El controlador no puede llamar a la rutina, pero el controlador todavía se carga en el sistema operativo.
No se obtiene ninguna mejora del rendimiento mediante la dirección devuelta por NdisGetRoutineAddress en lugar de llamar a la rutina especificada por nombre. Por lo tanto, no escriba un controlador NDIS para usar NdisGetRoutineAddress si sabe que la versión NDIS con la que el controlador ejecutará exporta la rutina especificada.
Normalmente, un controlador NDIS llama a NdisGetRoutineAddress en su rutina de DriverEntry de.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisGetRoutineAddress (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisGetRoutineAddress (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |