DEBUGREGISTER, RETAILREGISTERZONES (Windows CE 5.0)
These macros register the current module (a DLL or process) and its associated debug zone with the kernel subsystem.
DEBUGREGISTER (hMod)
Parameters
- hMod
Module handle.
Return Values
None.
Remarks
Call this macro from the main function of your process, or from the DllMain entry point of your DLL. For example, from the main function of a process, call:
DEBUGREGISTER(NULL);
From the entry point of a DLL, call:
DEBUGREGISTER(hInstDLL);
Where hInstDLL is the instance value that was passed to DllMain.
Calling this macro assumes that a global variable dpCurSettings has already been defined, where dpCurSettings must be a DBGPARAM structure.
DEBUGREGISTER registers debug zones for your process or module only on Debug builds.
RETAILREGISTERZONES registers debug zones on Debug and Retail builds.
To always register debug zones, no matter what build settings you use, use the RegisterDbgZones function.
Any module (a DLL or process) can register an associated debug zone mask with the kernel debug subsystem using this macro. 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
Send Feedback on this topic to the authors