# 函数：range_start

| C函数原型 | aclError aclprofRangeStart(void \*stamp, uint32\_t \*rangeId) |
| --- | --- |
| Python函数 | range\_id, ret = acl.prof.range\_start(stamp) |
| 函数功能 | msproftx用于记录事件发生的时间跨度的开始时间。同步接口。 调用此接口后，Profiling自动在Stamp记录采集开始的时间戳，将Event type设置为Start/Stop，生成一个进程唯一的id，并将Stamp保存在以进程粒度维护的一个map中。 |
| 输入说明 | stamp：int，Stamp指针地址，指代msproftx事件标记。指定函数：create\_stamp接口的指针地址。 |
| 返回值说明 | range\_id：int msproftx事件标记的唯一标识。用于在跨线程时区分。 ret：int，错误码。 返回0表示成功。 返回其它值表示失败。 |
| 约束说明 | 与函数：range\_stop接口成对使用，表示时间跨度的开始和结束。 可以跨线程调用。 在函数：create\_stamp接口和函数：destroy\_stamp接口之间调用。 |
| 参考资源 | 接口调用示例，参见Profiling性能数据采集。 |
