Function: range_start

aclError aclprofRangeStart(void *stamp, uint32_t *rangeId)

range_id, ret = acl.prof.range_start(stamp)

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 stamp and sets the event type to Start or Stop. The tool also generates a unique process ID, and saves the stamp in a map maintained by process.

stamp: int, stamp pointer address, indicating the msproftx event stamp. Specifies the pointer address of the Function: create_stamp API.

range_id: int, unique ID of the msproftx event stamp. Used to distinguish between threads.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

• This API must be used in pair with Function: range_stop to indicate the start and end time of a time span.
• Cross-thread calls are supported.
• This API must be called between Function: create_stamp and Function: destroy_stamp.

For the API call example, see Profile Data Collection.