aclprofRangeStart

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

Function

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.

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.

Parent topic: msproftx Extension APIs