NdisGetRoutineAddress function (ndis.h)

Article
02/22/2024

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

Syntax

PVOID NdisGetRoutineAddress(
  [in] PNDIS_STRING NdisRoutineName
);

Parameters

[in] NdisRoutineName

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

Requirement	Value
Minimum supported client	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.
Target Platform	Universal
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI compliance rules	Irql_Miscellaneous_Function(ndis)