aclprofRangeStart
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.
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.
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
The value 0 indicates success, and other values indicate failure. For details, see aclError.
Parent topic: Profiling AscendCL API for Extension