msptiActivityPushExternalCorrelationId

Supported Products

Note: For details about Ascend product models, see Ascend Product Models.

Product Type	Supported
Ascend 950 products	√
Atlas A3 training series/Atlas A3 inference series	√
Atlas A2 training series/Atlas A2 inference series	√
Atlas 200I/500 A2 inference products	√
Atlas inference series	×
Atlas training series products	×

Description

This function creates a push-pop call stack for the current thread. If the MSPTI_ACTIVITY_KIND_EXTERNAL_CORRELATION function is enabled, when msptiActivityAPI is created in the push-pop stack, an msptiActivityExternalCorrelation corresponding to the msptiActivityAPI record is created for each msptiExternalCorrelationKind.

Function Prototype

msptiResult msptiActivityPushExternalCorrelationId(msptiExternalCorrelationKind kind, uint64_t id)

Parameter Description

Table 1 Command-line options

Type of the external API activity associated with the

Parameter Name	Input/Output	Description
kind	Input	. Currently, the valid value is xxx_CUSTOM0. Invoke the enumeration class msptiExternalCorrelationKind.
id	Input	is the correlation ID generated by an external component, which is used to push data to the stack specified by the MSPTI.

Return Values

MSPTI_SUCCESS indicates that the operation is successful. If the external correlation type is invalid, MSPTI_ERROR_INVALID_PARAMETER is returned. If the external correlation ID stack is empty, MSPTI_ERROR_QUEUE_EMPTY is returned, indicating that the operation fails.