The NdisGetRoutineAddress function returns the address of a routine given the routine's name.
- NdisRoutineName [in]
A pointer to a UNICODE_STRING structure that specifies the string that contains the name of a routine.
Returns the address of the routine whose name is specified at NdisRoutineName if the routine is available; otherwise, NULL.
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.
|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.|
DDI compliance rules