|
<< Click to Display Table of Contents >> Navigation: NmxDLL Reference Guide > Nmx DLL Overview > Versions |
The version number of the NMX DLL consists of 4 parts, which are separated by a dot, e.g. V1.3.0.12. The meaning of the parts is:
Part of the version number |
Meaning |
|---|---|
1. Part, in the example: 1 |
"Major" version number It is incremented, if the NMX DLL is completely redesigned (-> happens seldom). |
2. Part, in the example: 3 |
"Minor" version number It is incremented, if new functionality has been implemented. |
3. Part, in the example: 0 |
"Patch" It in incremented, if one ore more bugs have been fixed. |
4. Part, in the example: 12 |
"Build" Internal number for revision identification. |
To ensure a long-term backward compatibility, newer versions may have additional functionality, but existing functionality remains unchanged (except bug-fixes). Therefore each function call has a separate suffix at its end: _1
An example is NMX_StaticGet32_1.
If a newer version of an existing function is implemented, a copy of the existing function call is made an the suffix is incremented. Following the example, a newer version would be named NMX_StaticGet32_2, whereas the existing function call remains unchanged.
It is strongly recommended to check for a minimum DLL version after startup of your measurement software (especially the Major and Minor part). Use NMX_GetDllVersion_1 for this purpose.
The NMX DLL may support functionality, which is not supported by the measurement system ("device"). This can be either since it is limited in functionality or since its firmware version is outdated. The function call will then return with the return code "NST_REQ_VERS_NOSUPPORT".