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

#### 产品支持情况

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


#### 功能说明

支持用户在网络指定位置下发自定义的Profiling打点。异步接口。


#### 函数原型

```
aclError aclrtProfTrace(void *userdata, int32_t length, aclrtStream stream)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| userdata | 输入 | 自定义信息。 |
| length | 输入 | userdata的长度，单位Byte。 length建议配置为18字节；如果未满18字节，将会自动在数据末尾补0到18字节；如果超过18字节，接口会校验报错返回。 |
| stream | 输入 | 指定执行打点任务的Stream。类型定义请参见aclrtStream。 |


#### 返回值说明

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