函数:range_start
产品支持情况
产品 |
是否支持 |
---|---|
|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
功能说明
msproftx用于记录事件发生的时间跨度的开始时间。
调用此接口后,Profiling自动在Stamp记录采集开始的时间戳,将Event type设置为Start/Stop,生成一个进程唯一的id,并将Stamp保存在以进程粒度维护的一个map中。
函数原型
- C函数原型
1
aclError aclprofRangeStart(void *stamp, uint32_t *rangeId)
- python函数
1
range_id, ret = acl.prof.range_start(stamp)
参数说明
参数名 |
说明 |
---|---|
stamp |
int,Stamp指针地址,指代msproftx事件标记。指定函数:create_stamp接口的指针地址。 |
返回值说明
返回值 |
说明 |
---|---|
range_id |
int,msproftx事件标记的唯一标识。用于在跨线程时区分。 |
ret |
int,错误码。
|
约束说明
- 与函数:range_stop接口成对使用,表示时间跨度的开始和结束。
- 可以跨线程调用。
- 在函数:create_stamp接口和函数:destroy_stamp接口之间调用。
父主题: msproftx扩展接口