产品	是否支持
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	x
Atlas 训练系列产品	x
Atlas 200/300/500 推理产品	x

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

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

msptiResult msptiActivityPushExternalCorrelationId(msptiExternalCorrelationKind kind, uint64_t id)

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

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