Unicode or ANSI?

 

All the API functions are provided in Unicode and ANSI variants where strings are used. We've also provided a character width neutral #define in the same fashion that the Windows.h header files do.

 

For example the function for naming a heap is provided as mvSetThreadNameA(), mvSetThreadNameW() with the character width neutral mvSetThreadName() mapping to mvSetThreadNameW() for unicode and mvSetThreadNameA() for ANSI.

 

In this document we're going to use TCHAR like the Window.h header files do.

 

All the API functions are declared as extern "C", so they can be used by C users and C++ users.

 

To use these functions #include svlMVAPI.h into your code.

 

 

Documentation, A or W?

 

Where there are functions that take strings we document the function as mvFunction(), but they will be implemented as mvFunctionA() for ANSI or mvFunctionW() for Unicode, using the same convention that Microsoft uses to document their functions.