ETS-Lindgren HI-6006, User Manual, Page: 59 / 92

59 58
APPENDIX D: ETSPROBE DLL USER GUIDE
The ETS-Lindgren ETSProbe DLL allows users to communicate with one or
more supported ETS-Lindgren field probes. The main deliverable consists of a
Microsoft® Windows® Dynamic Link Library (DLL) that can be called by a wide
variety of programming languages.
ETSProbe DLL is intended for users who want to integrate ETS-Lindgren probes
into their own software system.
About Redistribution
Redistribution and use in source and binary forms, with or without
modification, are permitted provided the following conditions are met:
• Redistributions of source code must retain the ETS-Lindgren copyright
notice, this list of conditions, and the following disclaimer.
• Redistributions in binary form must reproduce the ETS-Lindgren
copyright notice, this list of conditions, and the following disclaimer in the
documentation and/or other materials provided with the distribution.
(Disclaimer) Neither the name ETS-Lindgren nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
Getting Started
1. Download ETSProbe DLL from ets-lindgren.com.
2. Install ETSProbe DLL using the included automatic installer.
During installation (provided the installation path is not altered), an
assortment of example programs in various languages will be copied to C:\
Program Files\ETS-Lindgren\ETSProbe DLL\examples.
3. Create your new program or adapt your existing program to interface with
ETSProbe DLL.
DLL Function Calling Conventions
1. The function call stack/style is the WinAPI style. This allows the widest
variety of users to be able to call these functions.
2. The functions take and return only basic types of arguments (32 bit
integer, floating point values, and simple c-style zero terminated strings).
3. All outbound string parameters are allocated by the caller and are followed
in the argument list by a maximum string length integer parameter.
4. For the same reason, the functions do not take in or send out any object
style parameters.
5. All functions have an integer return value such that 0 will signify successful
completion. All other values that can be returned are function-specific.