跳到主要内容

aclprofPop

aclprofMark​

函数功能​

msproftx标记瞬时事件。同步接口。

调用此接口后，Profiling自动在Stamp指针中加上当前时间戳，将Event type设置为Mark，表示开始一次msproftx采集。

约束说明​

在aclprofCreateStamp接口和aclprofDestroyStamp接口之间调用。

函数原型​

aclError aclprofMark(void *stamp)

参数说明​

参数名输入/输出说明
stamp输入Stamp指针，指代msproftx事件标记。 指定aclprofCreateStamp接口的指针。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

aclprofPush​

函数功能​

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

调用此接口后，Profiling自动在Stamp指针中记录开始的时间戳，将Event type设置为Push/Pop。

约束说明​

函数原型​

aclError aclprofPush(void *stamp)

参数说明​

参数名输入/输出说明
stamp输入Stamp指针，指代msproftx事件标记。 指定aclprofCreateStamp接口的指针。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

aclprofPop​

函数功能​

msproftx用于记录事件发生的时间跨度的结束时间。同步接口。

调用此接口后，Profiling自动在Stamp指针中记录采集结束的时间戳。

约束说明​

函数原型​

aclError aclprofPop()

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

aclprofRangeStart​

函数功能​

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

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

约束说明​

函数原型​

aclError aclprofRangeStart(void *stamp, uint32_t *rangeId)

参数说明​

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

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

aclprofRangeStop​

函数功能​

msproftx用于记录事件发生的时间跨度的结束时间。同步接口。

调用此接口后，Profiling自动在Stamp指针中记录采集结束的时间戳。

约束说明​

函数原型​

aclError aclprofRangeStop(uint32_t rangeId)

参数说明​

参数名输入/输出说明
rangeId输出msproftx事件标记的唯一标识。用于在跨线程时区分。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

aclprofDestroyStamp​

函数功能​

释放msproftx事件标记。同步接口。

约束说明​

与aclprofCreateStamp接口配对使用，在aclprofStop接口前调用。

函数原型​

void aclprofDestroyStamp(void *stamp)

参数说明​

参数名输入/输出说明
stamp输入Stamp指针，指代msproftx事件标记。 指定aclprofCreateStamp接口的指针。

参考资源​

接口调用示例，参见Profiling性能数据采集。

父主题： Profiling AscendCL API for Extension（Profiling AscendCL API扩展接口）

在线提单