NdisGetRoutineAddress function

The NdisGetRoutineAddress function returns the address of a routine given the routine's name.

Syntax


PVOID NdisGetRoutineAddress(
  _In_  PNDIS_STRING NdisRoutineName
);

Parameters

NdisRoutineName [in]

A pointer to a UNICODE_STRING structure that specifies the string that contains the name of a routine.

Return value

Returns the address of the routine whose name is specified at NdisRoutineName if the routine is available; otherwise, NULL.

Remarks

An NDIS driver can use NdisGetRoutineAddress to obtain the address of an exported NDIS routine. The driver can then use this address to call the NDIS routine.

An NDIS driver can use NdisGetRoutineAddress if the driver must remain backward compatible. For example, if such a driver imports an NDIS routine that is not exported by the version of NDIS that is currently running, the I/O manager will not load the driver on the operating system. However, the driver can first use NdisGetRoutineAddress to determine whether the routine is available in the version of NDIS that is currently running. If available, the address of the routine is returned. The driver can then use the address to call the routine. If not available, NULL is returned. The driver cannot call the routine, but the driver still loads on the operating system.

No performance improvement is gained by using the address that is returned by NdisGetRoutineAddress instead of calling the specified routine by name. Therefore, do not write an NDIS driver to use NdisGetRoutineAddress if you know that the NDIS version with which the driver will run exports the specified routine.

Typically, an NDIS driver calls NdisGetRoutineAddress in its DriverEntry routine.

Requirements

Version

Supported for NDIS 6.0 and NDIS 5.1 drivers (see NdisGetRoutineAddress (NDIS 5.1)) in Windows Vista. Supported for NDIS 5.1 drivers (see NdisGetRoutineAddress (NDIS 5.1)) in Windows XP.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

DDI compliance rules

Irql_Miscellaneous_Function

See also

DriverEntry
UNICODE_STRING

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.