In addition to the run time kit the SDK also includes the following files.
Building an application requires a development environment that includes the Windows platform, SDK, and compiler for the chosen programming language. The API directly supports C, C++, C#, and other languages that support the standard DLL calling interface.
The C header file MGHDLC.H contains the API constants, structures, and function prototypes. Languages other that C or C++ require conversion of these constants and structures, which maintain the same structure packing requirements. The API structures use a default packing of 8 bytes, as enforced by the #pragma pack(8) preprocessor command. If your compiler does not support this command, then you must remove them from the header file and configure your compiler to use the 8 byte structure packing.
Link the application with the API import library MGHDLC.LIB. This resolves the calls to the Dynamic Link Library MGHDLC.DLL.
The sample C programs are compiled and tested using Microsoft Visual C/C++ 6, Visual Studio 2005, and Borland C/C++ 5.5. Some modifications may be necessary to compile with other vendor's products. There is a sample program for each serial protocol.
The trace utility source demonstrates the use of the tracing API functions, and provides a starting point for development of application specific tracing. The unmodified trace utility should be adequate for most tracing needs.
This document is provided in a Microsoft Compiled HTML format for quick reference. An HTML version is maintained on the MicroGate website located at www.microgate.com.
| Previous | Contents | Next |