RegisterDbgZones (Windows CE 5.0)
This function is called by the DEBUGREGISTER and RETAILREGISTERZONES macros to register debug zone settings for a process or DLL.
BOOL RegisterDbgZones(HMODULEhMod,LPDBGPARAMlpdbgparam);
Parameters
- hMod
Handle for module - lpdbgparam
Parameters
Return Values
Returns TRUE if the debug zones were successfully registered.
Remarks
Call this function from the main function of your process, or from theDllMain entry point of your DLL. For example, from the main function of a process, call:
RegisterDbgZones(NULL, &dpCurSettings);
From the entry point of a DLL, call:
RegisterDbgZones(hInstDLL, &dpCurSettings);
Where hInstDLL is the instance value that was passed to DllMain.
Calling this function assumes that a global variable dpCurSettings has already been defined, where dpCurSettings must be a DBGPARAM structure.
RegisterDbgZones registers debug zones for your process or module for all build configurations. To register only debug zones on Debug builds, use the DEBUGREGISTER macro. To register debug zones on Debug and Retail builds, use the RETAILREGISTERZONES macro.
Any module (a DLL or process) can register an associated debug zone mask with the kernel debug subsystem using this function. Once the debug zones are registered, a user can then turn debug zones on or off programmatically using the DEBUGZONE macro.
Debug zones may also be turned on or off interactively from the Target Control window. You can interactively turn debug zones on or off by modifying bits of the registered debug zone mask.
Requirements
OS Versions: Windows CE OS 2.10 and later
Header: Dbgapi.h
Link Library: none
See Also
DEBUGREGISTER, RETAILREGISTERZONES
Send Feedback on this topic to the authors