功能介绍

功能

当用户需要定位应用程序或上层框架程序的性能瓶颈时，可在Profiling采集进程内（aclprofStart接口、aclprofStop接口之间）调用Profiling AscendCL API扩展接口（统称为msproftx功能），开启记录应用程序执行期间特定事件发生的时间跨度，并将数据写入Profiling数据文件，再使用Profiling工具解析该文件，并导出展示性能分析数据。

Profiling工具解析导出操作请参见《性能调优工具使用指南》下的“高级功能>数据解析与导出”。

接口调用方式：在aclprofStart和aclprofStop接口之间调用aclprofCreateStamp、aclprofSetStampTraceMessage、aclprofMark、aclprofMarkEx、aclprofPush、aclprofPop、aclprofRangeStart、aclprofRangeStop、aclprofDestroyStamp接口。该方式可获取应用程序执行期间特定时间发生的事件并记录事件发生的时间跨度。

一个进程内，可以根据需求多次调用这些接口。

接口约束说明

• 调用接口要求：msproftx功能相关接口须在aclprofStart接口与aclprofStop接口之间调用。其中配对使用的接口有：aclprofCreateStamp/aclprofDestroyStamp、aclprofPush/aclprofPop、aclprofRangeStart/aclprofRangeStop。
• 接口调用顺序：aclprofStart接口(指定Device 0和Device 1)-->aclprofCreateStamp接口-->aclprofSetStampTraceMessage接口-->aclprofMark接口-->(aclprofPush接口-->aclprofPop接口)或(aclprofRangeStart接口-->aclprofRangeStop接口)-->aclprofDestroyStamp接口-->aclprofStop接口(与aclprofStart接口的aclprofConfig数据保持一致)。