msptiActivityPushExternalCorrelationId

产品支持情况

说明： 昇腾产品的具体型号，请参见《昇腾产品形态说明》。

产品类型	是否支持
昇腾950代际产品	√
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	×
Atlas 训练系列产品	×

功能说明

此函数为当前线程创建push-pop调用栈。如果启用了MSPTI_ACTIVITY_KIND_EXTERNAL_CORRELATION功能，在push-pop栈内创建msptiActivityAPI时，会为每一种msptiExternalCorrelationKind创建一个与msptiActivityAPI记录对应的msptiActivityExternalCorrelation。

函数原型

msptiResult msptiActivityPushExternalCorrelationId(msptiExternalCorrelationKind kind, uint64_t id)

参数说明

表 1 参数说明

参数名	输入/输出	说明
kind	输入	关联的外部API活动类型，当前有效kind为xxx_CUSTOM0。调用枚举类msptiExternalCorrelationKind。
id	输入	由外部组件生成的关联ID，用于push到MSPTI指定的stack里。

返回值说明

返回MSPTI_SUCCESS表示成功；外部关联类型无效时返回MSPTI_ERROR_INVALID_PARAMETER和外部关联ID栈空时出栈返回MSPTI_ERROR_QUEUE_EMPTY，表示失败。