Microsoft Windows CE 3.0  

Testing NDIS Drivers

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Windows CE 3.0 features a built-in testing tool for testing NDIS miniport drivers. This testing tool, which is called NDISTest, allows you to perform functionality, stress, and performance tests on NDIS miniport drivers. NDISTest is implemented as a protocol driver and ships with a set of LAN test scripts. NDISTest for Windows CE 3.0 supports a GUI (NDTEST) that is similar to the NDISTest UI that is featured in Windows NT.

NDISTest achieves high flexibility by using the Hapi script interpreter. The Hapi script interpreter provides a simple, pseudo C-language environment that has built-in variable types and a control flow that resembles the C language. NDISTest allows you to test miniport drivers through a set of Hapi script files.

The following table shows the software requirements for NDISTest

The following diagram shows the NDISTest structure that is supported in Windows CE.

The Hapi.exe application, which is located at the top of the NDISTest architecture, represents the Hapi Script interpreter. Hapi.exe reads the Hapi.ini configuration file, sets up the correct configuration, and initializes the underlying Ndistst.dll file.

After it has been initialized by Hapi.exe, Ndistst.dll registers the underlying Ndtsys.dll file, which performs the functionality of a Windows CE protocol driver. Ndtsys.dll communicates with the underlying miniport driver through the NDIS wrapper, and passes the results of each driver query back to the Hapi script interpreter. Hapi.exe displays the results of each individual test through a GUI.

To run NDISTest on a Windows CE-based device requires a Windows CE device with a PCMCIA slot and a network adapter. To perform functional testing on two computers, you need to connect a Windows NT-based computer to a Windows CE-based device that has its own network adapter.



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.




Requirement Description
Hapi.exe Hapi script interpreter; reads Hapi configuration, initializes Ndistst.dll, and displays test results
H_core.dll Hapi core DLL
Ndistst.dll Hapi extension DLL; provides the Hapi shell with NDIS-specific commands — such as open, close, send, and receive.
Ndtsys.dll Windows CE NDIS-protocol DLL;
Ndtsys.dll is both a protocol driver and a stream interface driver; it is registered with Device.exe in the Ndistst.dll
Hapi.ini Hapi configuration file
Scripts\*.* Script files