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 de 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.

Comentarios

Un controlador NDIS puede usar NdisGetRoutineAddress para obtener la dirección de una rutina de 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 seguir siendo 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 se ejecutará el controlador exporta la rutina especificada.

Normalmente, un controlador NDIS llama a NdisGetRoutineAddress en su rutina DriverEntry .

Requisitos

Requisito	Value
Cliente mínimo compatible	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.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)

Consulte también

DriverEntry

UNICODE_STRING