Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The application developer may start a network interface by calling the NetIF_Start() API function with the necessary parameters. A call to NetIF_Start() is shown below.

L5-12(1) NetIF_Start() requires two arguments. The first function argument is the interface number that the application wants to start, and the second argument is a pointer to a NET_ERR to contain the return error code. The interface number is acquired upon successful addition of the interface and upon the successful start of the interface; the return error variable will contain the value NET_IF_ERR_NONE.

There are very few things that could cause a network interface to not start properly. The application developer should always inspect the return error code and take the appropriate action if an error occurs. Once the error is resolved, the application may again attempt to call NetIF_Start().