How to Replace the Network UI for a Target Device (Windows CE 5.0)

Windows CE 5.0

The Network User Interface (UI) Catalog item defines the user interface components that are used by networking and device driver modules in the Windows CE operating system (OS). This includes the Network and Dial-up Connections application. Network UI provides a set of dialog boxes that can be used by other applications. Network UI functions are contained in Netui.dll, and are accessed by the operating system through wrappers in the %_WINCEROOT%\Public\Common\Oak\Inc\Netui.h file. Therefore, to match the desired users' experience, you can omit implementation of any of these functions from Netui.dll, change the sample implementations to suit the user interface requirements for specific device, or omit the Netui.dll entirely.

Note   The wrappers in Netui.h attempt to find the appropriate function in Netui.dll. If no appropriate function is found, or if netui.dll is not present, Netui.h will return an error code and output a message to the debug console that it could not find the requested function.

Hardware and Software Assumptions

  • Your Platform Builder installation includes the CEPC x86 board support package (BSP).
  • You have a CEPC already configured. For more information, see How to Set Up a CEPC and How to Use the IDE to Create, Customize, and Build a Run-Time Image.
  • You have created an OS design that includes the Network User Interface. For information about creating an OS design, see Creating an OS Design. For information about adding a Catalog item to the OS design, see Adding an Item from the Catalog.

    If you do not have a specific OS design created, and instead want to use these steps as a tutorial, choose the Enterprise WebPad design template when you create your OS design.

  • You know the changes that you want to make in the Network UI. The source code for the implemented dialog boxes is in the %_WINCEROOT%\Public\Common\Oak\Drivers\Netui directory.

    For information about the functions that are included in the netui module, see netui Module.

To track your progress in the following table, select the check box next to each step.

 StepTopic
1. Customize the network UI as desired.Customizing the Network UI
2. Prepare to build the run-time image.
  • Choose the debug build.
Building and Downloading a Run-time Image
3. If your final run-time image size is estimated to be larger than 32 MB, such as if you are creating the Enterprise WebPad example, you must perform the following steps:
  • From the Platform menu, choose Settings.

    The Platform Settings dialog box appears.

  • Choose the Build Options tab.
  • Select the Run-Time Image Can be Larger than 32 MB (IMGRAM64=1) check box.
  • Choose OK to close the dialog box.
 
4. Build the run-time image.Building a Run-Time Image
5. Configure the connection to the CEPC.
  • In the Target Device box, choose your OS design name.
Configuring a Connection for Downloading and Debugging
7. Download the Image to the CEPC.Downloading a Run-Time Image to a CEPC
8. Test the Network UI change.Testing the Network UI change

See Also

Network User Interface | How-to Topics | Functions Exported by the Network UI


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show: