CeLogFlush Registry Settings (Windows CE 5.0)
You can modify the behavior of the CeLogFlush application that flushes the CeLog log by changing specific registry values.
The CeLog registry settings are located under the HKEY_LOCAL_MACHINE\System\CeLog key.
The following list shows ways in which you can change the registry settings:
- Typically, to create a run-time image with predefined settings, add registry settings to the projects file before building the run-time image.
- You can also use the Remote Registry Editor in Platform Builder to add the settings to a device. However, changes made from the Remote Registry Editor are not persistent to the registry files. Therefore, the next time that you download the image, you must configure the registry again. For more information, see Remote Registry Editor.
The following table shows the named values you can set for the CeLog key.
Value: type | Default | Description |
---|---|---|
BufferSize: REG_DWORD | 0x00020000 = 131072, or 128KB | Specifies the size, in bytes, of the CeLog RAM buffer that stores event activity before flushing. |
FileFlags: REG_DWORD | 0 | Specifies flags for file management. Choose one of the following:
|
FileName: REG_SZ | \Release\celog.clg | Name of log file to store the data in. |
FlushTimeout: REG_DWORD | 0x00002710 = 10000, or 10 seconds | Sets the timeout, in milliseconds, between successive flushes. |
ThreadPriority: REG_DWORD | 0x000000F8 = 248, the lowest real-time priority | Sets the priority of the flushing thread (0-255). |
Transport: REG_SZ | LocalFile | Transport to use. This value must be one of the following:
|
UseUI: REG_DWORD | 0 | Boolean value that indicates type of messages.
1=use popup messages 0=debug messages only |
ZoneCE: REG_DWORD | Previous zone setting | Specifies the CeLog zone settings.
If this value is present, CeLogFlush will call CeLogSetZones to pass the zones to CeLog. |
Examples
The following examples show how to set common registry values that control CeLogFlush behavior.
Default
These settings store the data in a log file called celog.clg in the release directory on the host PC.
[HKEY_LOCAL_MACHINE\System\CeLog] "Transport"="LocalFile" "FileName"="\\release\\celog.clg"
The default file name, \release\celog.clg, requires the release file system, relfsd, to transport the data. Because of this, the default settings for CeLogFlush require a KITL connection to Platform Builder on the development workstation.
Log file stored at root directory.
This example stores the log file in the root of the file system on the device. It does not require a connection to the development workstation.
[HKEY_LOCAL_MACHINE\System\CeLog] "Transport"="LocalFile" "FileName"="celog.clg"
Log file on a storage card.
This method requires a storage card on a device.
[HKEY_LOCAL_MACHINE\System\CeLog] "Transport"="LocalFile" "FileName"="\\Storage Card\\celog.clg"
Flush every second
[HKEY_LOCAL_MACHINE\System\CeLog] "FlushTimeout"=dword:3E8
Low priority of flush thread
This method lowers the thread priority for log flush from the default of 248 to 251, which corresponds to THREAD_PRIORITY_NORMAL**.**
[HKEY_LOCAL_MACHINE\System\CeLog] "ThreadPriority"=dword:FB
See Also
Real-time Priority System Levels | CeLogFlush Command-Line Overrides
Send Feedback on this topic to the authors