Project / Makefile Settings: Symbol Definitions

MPI_DECL1/MPI_DECL2 | MEI_ASSERT | MEI_PLATFORM

This section describes compile-time symbol definitions used by the MPI library.

MPI_DECL1 / MPI_DECL2

These symbols are used in library header files to handle compiler-specific language extensions when declaring external functions and data; in particular, those extensions used when making Win32 dynamic link libraries (DLLs). MPI_DECL1 precedes the return type of a function declaration; MPI_DECL2 follows the return type and precedes the function name:

          MPI_DECL1 long MPI_DECL2 mpiModuleFunction();

Use the following symbol definitions when building an application or the MPI library.

MEI_ASSERT

When defined, MEI_ASSERT will cause calls to the macro mpiASSERT(expression) to be compiled into the library. Otherwise, these calls will be discarded by the preprocessor.

The meiAssert(...) macro is used by the library and is available to applications. It is a valuable debugging tool that can be used to catch programming errors at their source and prevent them from spreading. If the argument to the macro is TRUE (i.e. non-zero), execution proceeds normally. Otherwise, an error message is displayed; the message contains the name of the file and the line number of the meiAssert(...) call. The application exits after displaying the message.

The MEI_ASSERT define is also required for the msgCHECK(...) macro to work. msgCHECK(...) is use throughout the sample applications and utilities.

MEI_PLATFORM

The MEI_PLATFORM symbols are used to indicate the platform for which the library and applications are built. Each platform has its own unique symbol.

Standard platform define:

Supported platforms, requires platform specific release (contact Kollmorgen for availability):

Reserved for future use:

Legacy platforms (no longer supported):

NOTE: Existence of an MEI_PLATFORM symbol for a potentially supported platform does not imply intent to support that platform.