---
title: aclprofRangeStart
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_1274.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1274.html
indexId: 842d79398cd1cd4cb5e29ada39e6167c39e7f56074f130a6fa93c230bc7715b368
---
# aclprofRangeStart

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

msproftx用于记录事件发生的时间跨度的开始时间。

调用此接口后，Profiling自动在Stamp指针记录采集开始的时间戳，将Event type设置为Start/Stop，生成一个进程唯一的id，并将Stamp保存在以进程粒度维护的一个map中。


#### 函数原型

```
aclError aclprofRangeStart(void *stamp, uint32_t *rangeId)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| stamp | 输入 | Stamp指针，指代msproftx事件标记。 指定aclprofCreateStamp接口的指针。 |
| rangeId | 输出 | msproftx事件标记的唯一标识。用于在跨线程时区分。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。


#### 约束说明

- 与  aclprofRangeStop
接口成对使用，表示时间跨度的开始和结束。
- 在  aclprofCreateStamp
接口和  aclprofDestroyStamp
接口之间调用。
- 可以跨线程调用。