RTFW is a native DLL that allows C/C++ applications to configure and control the wRTOS Subsystem programmatically. This interface provides similar functionality as the Managed Code Framework.
The configuration functions of this interface get and set configuration values that will be used on the next start of the wRTOS Subsystem. This means that if the Subsystem is running, changes may not take effect until a restart occurs. Considering this, the values you get may not match the values in use by the currently running Subsystem, since they may have already been changed after the Subsystem was started.
Recommendations for using the RTFW library:
- Always call the Get version of a call to fill in structures, make your setting changes, and then call the Set version of the function.
- If the Subsystem is running and you modify a Subsystem or TCP/IP Stack setting, check the GetLastError return. This will notify you if a restart of the Subsystem or TCP/IP Stack is needed for the changes to take effect.
- Check for a required restart after calling any API that can change the Subsystem or network configuration. You can do this:
- via the two custom error codes, RT_ERROR_RESTART_SUBSYSTEM and RT_ERROR_RESTART_NETWORK, or
- by calling RtfwRestartRequired
Note: RTFW libraries can only be used in Windows applications.
Note: Network functionality was rearchitected for wRTOS 1.0. Network functions in RTX64 4.x and previous versions are incompatible with wRTOS 1.0.
Topics:
