Adding a Profile Mark to a .icp File
Other versions of this page are also available for the following:
8/27/2008
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
In the module, insert a
#include cecap.h
statement.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 valueMarkID
to the .icp file. - Insert a
CommentMarkProfile( MarkID, TextString )
function to add an identifier of valueMarkID
and a text string of valueTextString
to the .icp file. - Insert a
CommentMarkAtProfile( TimestampValue, MarkID, TextString )
function to add a timestamp of valueTimestampValue
, an identifier of valueMarkID
, and a text string of valueTextString
to the .icp file.
- 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
See Also
Concepts
Call Profiler Data Collection API Reference
Call Profiler Instrumented Module Building