Introduction

mCtrl Features

TODO

System Requirements and Compatibility Notes

MCTRL.DLL addresses MS Windows 2000 and newer (i.e. MS Windows 2000, MS Windows XP, MS Windows Server 2003, MS Windows Vista, MS Windows Server 2008 and MS Windows 7), both 32 and 64-bit versions.

Unfortunatly for capacity and availability reasons, the mCtrl is regularly tested on MS Windows XP (32-bit). MS Windows 2000 and Vista are tested only on sendom opportunity, as well as 64-bit builds on 64-bit systems.

Debug Level

MCTRL.DLL provides some debugging facilities which can be turned on or off. The debugging level is controlled with preprocessor macro DEBUG during building of MCTRL.DLL.

Value 0 means the debugging is disabled ("Release" version). This is expected to be used with the final release of the application.

Value 1 enables the "Debug" build. This implies several points:

This MCTRL.DLL variant is recommanded as first step if your application based on MCTRL.DLL does not do what it should. It can be very well used during application development, switching to the release MCTRL.DLL only in release-candidate stage of your deveoplment cycle.

The traces can give you a valuable information what's going wrong and that can often directly point to a bug in your application or in mCtrl.

Value 2 enables everyting what value 1 does and additionally enables tracking memory allocation and releases performed inside of MCTRL.DLL. It can help the classical memory management bugs like memory leaks, multiple freeing of the same memory block, buffer overruns or underruns etc.

This is especially usuful when debugging MCTRL.DLL, but it can also be used to check that there are no leaks in your application caused by calling some function from MCTRL.DLL allocating some resource which is not paired with corresponding releasing function. Typical example is that your application can call some initialization function (e.g. mcMditab_Initialize()) but not corresponding function (e.g. mcMditab_Terminate()).

However it is not intended for general use: it has higher memory and CPU consumtion, and tracing is much more verbous about the memory management, making the resulted log much longer.

When refering to "degbug build" of MCTRL.DLL without specifying the debug level, DEBUG=1 is usually assumed.

Some extra debugging traces can also be turned on for some mCtrl modules by defining additional preprocessor macros, but these are intended only for mCtrl own development and bug hunting, so these are not covered here.


Generated on Wed Nov 4 00:45:25 2009 for mCtrl by  doxygen 1.5.9