aclprofRangeStart
Applicability
Product |
Supported |
|---|---|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
Description
Records the start time of the time span by msproftx when an event occurs.
After this API is called, the Profiling tool automatically records the start timestamp in the stamp pointer and sets the event type to Start/Stop. The tool also generates a unique process ID, and saves the stamp in a map maintained by process.
Prototype
aclError aclprofRangeStart(void *stamp, uint32_t *rangeId)
Parameters
Parameter |
Input/Output |
Description |
|---|---|---|
stamp |
Input |
Stamp pointer, indicating a msproftx event stamp. This API is used to specify the pointer to aclprofCreateStamp. |
rangeId |
Output |
Unique ID of a msproftx event stamp. Used to distinguish between threads. |
Returns
0 on success; else, failure. For details, see aclError.
Restrictions
- This API must be used in pair with aclprofRangeStop to indicate the start and end time of a time span.
- This API must be called between aclprofCreateStamp and aclprofDestroyStamp.
- Cross-thread calls are supported.