API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

FUNCTION: DBGEVENT_EX()

Brew Release
Brew MP 1.0.2
See Also
Helper Functions
Description
This function is used to output debugging events. Since this function may be implemented in different ways on different platforms, care must be taken with this function to get useful results.
In general DBGEVENT Event Codes map to the standard BREW Events listed in AEE.h, although not all the standard BREW Events are supported on all platforms.
The minimum standard BREW Events that should be supported on all platforms are:

EVT_APP_START
EVT_APP_STOP
EVT_APP_SUSPEND
EVT_APP_RESUME
EVT_EXT_CREATE
EVT_EXT_RELEASE
EVT_ASYNC_ERROR
EVT_USER
In addition, users may send their own events. User-defined event codes must be equal to or larger than EVT_USER.
For example, if the application's custom event is the fifth user event:
#define EVT_APP_CUSTOM EVT_USER+5
On the Windows SDK, the event shows up in the BREW Simulator "Output Window." Each call to DBGEVENT() generates at most 128 bytes of output.
On Qualcomm chipset-based platforms, events sent using DBGEVENT() are delivered via the diag port (though this may change).
In general, DBGEVENT()'s behavior is platform-dependent, so a platform-specific understanding of how these events are defined and delivered is required.
Params
evt
[]:
AEE Event code to log.
cls
[]:
Class ID of the sending application, extension, or interface.
pl
[]:
User-defined payload.
Prototype
  •    void dbgevent(AEEEvent evt, AEECLSID cls, uint32 pl);
       
    
Return
  • None
Side Effect
  • None
Comments
None