Adding a Profile Mark to a .icp File (Windows Embedded CE 6.0)

1/5/2010

You can add a Remote Call Profiler function to your code that inserts a profile mark into the Remote Call Profiler profiling data (.icp) file when the code executes. A profile mark is a numeric identifier that can be accompanied by a text string and a time stamp.

You can use a profile mark to specify the start or end of data returned in Remote Call Profiler views. You can use the value of a time stamp to synchronize external events. For more information about the Remote Call Profiler API, see Remote Call Profiler Data Collection Functions.

To add a profile mark to a .icp file

1. In the module, insert a #include cecap.h statement.

2. Choose from the following:

   • At the place in the code for your application where you want the application to add a profile mark to the .icp file, insert a MarkProfile( MarkID ) function to add an identifier of value MarkID to the .icp file.
   • Insert a CommentMarkProfile( MarkID, TextString ) function to add an identifier of value MarkID and a text string of value TextString to the .icp file.
   • Insert a CommentMarkAtProfile( TimestampValue, MarkID, TextString ) function to add a timestamp of value TimestampValue, an identifier of value MarkID, and a text string of value TextString to the .icp file.

See Also

Concepts

Call Profiler Data Collection API Reference
Call Profiler Instrumented Module Building