FireSync API
 All Classes Files Functions Variables Typedefs Friends Macros Modules Pages
kProfileProbe Class Reference

Description

Represents a code profiling probe.

Profiling probes are associated with a health collection provider. A default health collection provider may be installed by the application environment. If not, or if a more specific collection provider is desired, the kProfileProbe_ConstructEx constructor can be used to construct a probe and attach it to the specified provider.

Code profiling probes are intended to efficiently measure the elapsed time of relatively brief operations. As such, profiling timers may overflow and produce incorrect results if used to measure operations that require longer than a few seconds. If a long duration needs to be meausred, consider using kTimer and kHealthProbe instead of kProfileProbe.

Code profiling is effectively disabled unless the K_PROFILE prepocessor flag is defined.

Public Member Functions

kStatus kProfileProbe_Construct (kProfileProbe *probe, const kChar *name, kAlloc allocator)
 Constructs a kProfileProbe object attached to the default health provider. More...
 
kStatus kProfileProbe_ConstructEx (kProfileProbe *probe, kHealth provider, const kChar *name, kAlloc allocator)
 Constructs a kProfileProbe object attached to the specified health provider. More...
 
const kCharkProfileProbe_Name (kProfileProbe probe)
 Reports the name of the profile probe. More...
 
void kProfileProbe_Start (kProfileProbe probe)
 Begins a code profiling measurement. More...
 
void kProfileProbe_StartEx (kProfileProbe probe, kProfileContext *context)
 Begins a thread-safe code profiling measurement. More...
 
void kProfileProbe_Stop (kProfileProbe probe)
 Ends a code profiling measurement. More...
 
void kProfileProbe_StopEx (kProfileProbe probe, kProfileContext *context)
 Ends a thread-safe code profiling measurement. More...
 

The documentation for this class was generated from the following file: