CeLogSetZones (Compact 2013)

3/28/2014

This function is called to change the current logging zones.

Syntax

void CeLogSetZones(
  DWORD dwZoneUser, 
  DWORD dwZoneCE, 
  DWORD dwZoneProcess 
);

Parameters

  • dwZoneUser
    [in] Indicates the user zones to be logged. The hexadecimal bit mask lets each bit represent a zone to log for user-defined zones.
  • dwZoneCE
    [in] Indicates the operating system (OS) zones to be logged. The hexadecimal bit mask lets each bit represent a zone to log for OS-defined zones. The default value is 0xFFBFFFFF (KCALLS off).
  • dwZoneProcess
    [in] Indicates the processes to be logged. The hexadecimal bit mask lets each bit represents a process for which to log events. The default value is 0xFFFFFFFF (all processes).

Return Value

None.

Remarks

If the bit is set, the zone or process is logged.

Although this function provides three zone values for you to manipulate, only the CE zone will affect the collection of data on your device. The user and process zones are unused.

To disable logging, set the CE zone to zero. To enable logging, set the CE zone to a bitmask of one or more available zones.

If logging was previously disabled, you may have to call CeLogReSync to make the kernel create a list of the existing processes, threads, and modules. Tools such as the Kernel Tracker service provider use this list to display the log contents. If the log does not contain the current list of processes and threads, Kernel Tracker cannot graphically display thread activity.

You can also determine the current CeLog zone settings, and the set of zones that are available for use, by calling CeLogGetZones.

Requirements

Header

celog.h

Library

coredll.lib

See Also

Reference

CeLog Event Tracking Functions
CeLogGetZones
CeLog Zones