UPnP AV Framework Debug Zones
A version of this page is also available for
4/8/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
};