Enabling CeLog Zones During Boot (Windows CE 5.0)
If your target device is connected to a development workstation using a KITL connection, you can set CeLog zones that control the CeLog collection process during boot by setting a registry data value on your development workstation rather than on the device.
The value in the registry of the development workstation is read only once, when the device boots. It provides the initial zone settings. If this value is not present, all zones except CELZONE_KCALL are turned on by default. In other words, the default zone setting is 0xFFBFFFFF if no registry value is present.
On the development workstation, zones are enabled with a hexadecimal bit mask, in which each bit represents a zone to log. If a bit is set, the corresponding zone or process is logged; otherwise, it is not logged.
For information on supported zones, see CeLog Zones.
The following table shows the zone value that can be set in the registry of the development workstation at the HKEY_CURRENT_USER\Pegasus\Zones key.
| Zone argument | Description |
|---|---|
| CeLogZoneCE: REG_DWORD | Indicates which OS zones are to be logged. |
By setting CeLogZoneCE to 0 on boot, and then turning on logging with CeLogSetZones after the device is running, you can trigger logging during a specific activity.
You can also set CeLogZoneCE to a non-zero value to enable one or more zones. To combine zones, set CeLogZoneCE to the bitwise OR of their values. For example, if you set CeLogZoneCE=0x00000062, CeLog will capture all data logged to CELZONE_RESCHEDULE, CELZONE_THREAD and CELZONE_PROCESS.
Note CeLog logs events pertaining to device boot if you enable the zone CELZONE_BOOT_TIME. For information on how to view these events after you have collected them, see Viewing Boot Events With Readlog.
Remarks
If a log flushing application, such as CeLogFlush.exe or OSCapture.exe, is in use, then the zone settings from the target device registry can override zone settings from the development workstation.
As it loads, CeLog.dll reads the initial zone setting from the registry of the development workstation. CeLog.dll does not read the setting a second time.
The flushing applications, CeLogFlush.exe and OSCapture.exe, begin to run after CeLog is loaded and after CeLog reads the initial zone setting. These applications read zone settings from the target device registry, rather than from the development workstation. The flushing applications update the initial zone values to the new zone value from the target device with a call CeLogSetZones.
For more information about how to control the CeLog zones using the registry of the target device, see CeLogFlush Registry Settings or OSCapture Registry Settings.
See Also
IOCTL_CELOG_GETDESKTOPZONE | CeLog Zones | Capturing CeLog Data During Boot
Send Feedback on this topic to the authors