昇腾社区首页
中文
注册

msptiActivityPushExternalCorrelationId

函数原型

msptiResult msptiActivityPushExternalCorrelationId(msptiExternalCorrelationKind kind, uint64_t id);

函数功能

为调用线程推送外部关联ID。

此函数通知MSPTI调用线程进入外部API区域。当在外部API区域内创建MSPTI活动API记录并且启用了MSPTI_ACTIVITY_KIND_EXTERNAL_CORRELATION时,对于每个msptiExternalCorrelationKind,活动API记录的前面将有一个msptiActivityExternalCorrelation记录。

参数说明

表1 参数说明

参数

输入/输出

说明

kind

输入

关联的外部API活动类型,当前有效kind为xxx_CUSTOM0。调用枚举类msptiExternalCorrelationKind

id

输入

由外部组件生成的关联ID,用于push到MSPTI指定的stack里。

返回值

返回MSPTI_SUCCESS表示成功,外部关联类型无效时返回CUPTI_ERROR_INVALID_PARAMETER和外部关联id栈空时出栈返回CUPTI_ERROR_QUEUE_EMPTY,表示失败。