NetDmaGetVersion function (netdma.h)
Note The NetDMA interface is not supported
in Windows 8 and later.
The NetDmaGetVersion function returns the version of the NetDMA interface that the local computer supports.
Syntax
NET_DMA_EXPORT UINT NetDmaGetVersion();
Return value
NetDmaGetVersion returns a UINT value that contains the major and minor version numbers as follows:
| Return code | Description |
|---|---|
|
The major version number of the NetDMA interface. |
|
The minor version of NetDMA interface. |
Remarks
NetDMA provider drivers can call the NetDmaGetVersion function to obtain the version of the NetDMA interface. A NetDMA provider must register as a NetDMA provider with a version equal to or lower than the NetDMA provider interface version that the local computer supports. The NetDMA provider driver specifies the major and minor version of the NetDMA provider in the MajorVersion and MinorVersion members of the NET_DMA_PROVIDER_CHARACTERISTICS structure that it passes to the NetDmaRegisterProvider function.
Note NetDmaGetVersion is not available in NetDMA version 1.0. To avoid using a function import that
might stop the driver from loading, a NetDMA 1.1 or later provider driver must verify the presence of
NetDmaGetVersion before it calls
NetDmaGetVersion. To call
NetDmaGetVersion, first call the
NdisGetRoutineAddress function to
get the entry point and then, if
NetDmaGetVersion is available, call
NetDmaGetVersion at the entry point that
NdisGetRoutineAddress provided. If the provider driver cannot get the address of
NetDmaGetVersion, the supported NetDMA interface must be version 1.0.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported for NetDMA 2.0 and NetDMA 1.1 drivers in Windows Server 2008. |
| Target Platform | Universal |
| Header | netdma.h (include Netdma.h) |
| IRQL | PASSIVE_LEVEL |