Use Debug Zones (Compact 2013)
3/26/2014
Windows Embedded Compact 2013 uses debug zones to control which debug messages are sent to the output stream. Each module has its own separate debug zones and can have at most 16 zones. If a zone is active, messages for that zone are sent to the output stream. If a zone is inactive, messages for that zone are suppressed.
The following list outlines the steps that you take to set up and use debug zones:
- Define the debug zones. Use macros to associate each debug zone with a bit in the bit field that specifies which debug zones are active. For more information, see Define Debug Zones.
- Set debug zone parameters. Name the module, name the debug zones, and specify the zones that are enabled by default to set the parameters for the debug zone. For more information, see Set Debug Zone Parameters.
- Register the debug zones. Register the debug zones with the kernel debug subsystem, so you can then turn debug zones on or off. For information on how to register debug zones, see Register Debug Zones.
- Set which debug zones are initially active. Use three ways to set which debug zones are active when a module loads. For more information, see Set Initial Debug Zones.
- Write debug messages that use debug zone macros. Use debug message macros to specify a message and the conditions under which the message is sent to the default output stream. For more information, see Create Debug Messages That Use Debug Zones.
- View the debug zones at runtime. View the debug zones of a module with an application such as Platform Builder. For more information, see View Debug Zones.
- Enable and disable debug zones at runtime. Turn zones on and off either programmatically or by using an application such as Platform Builder. For more information, see Change Active Debug Zones.