UPnP AV Framework Debug Zones (Windows Embedded CE 6.0)
1/6/2010
The UPnP AV Framework uses three debug zones to output errors, warnings, and informational tracing messages. Each EXE or DLL has its own set of debug zones.
The UPnP AV Framework functionality is defined in a static library that is linked into the same module as the code that uses the UPnP AV Framework. Because of this, the code that uses the UPnP AV Framework must define the UPnP AV Framework debug zones if it wants to output UPnP AV Framework debug zone information.
The first three debug zones in the dpCurSettings variable must be allocated to the UPnP AV Framework. To make allocation in your own modules easy, the ZONE_AV_ constants and DEFAULT_AV_ZONES constant (which uses the BIT_AV_ constants) are defined in av_upnp.h.
For example, the following dpCurSettings declaration defines all three UPnP AV Framework debug zones. The use of DEFAULT_AV_ZONES turns on the error and warning debug zones by default.
// Debug zones for this module
DBGPARAM dpCurSettings =
{
TEXT("<process or module name>"),
{
ZONE_AV_ERROR_NAME,
ZONE_AV_WARN_NAME,
ZONE_AV_TRACE_NAME,
... // all remaining strings using, for example, L""
},
DEFAULT_AV_ZONES // | any other default zones
};
For an example of how to accomplish these tasks, including code that uses the ZONE_AV_ name constants in the first three positions of the Setting Debug Zone Parameters structure, see the MediaRenderer.cpp file included with the AV Renderer sample. For more information, see UPnP AV Renderer Sample.
For general information about debug zones, see Windows Embedded CE topic Debug Messages.