aclmdlExecuteAsyncV2

Applicable Products

Product

Supported

Ascend 950PR / Ascend 950DT

×

Atlas A3 training products / Atlas A3 inference products

×

Atlas A2 training products / Atlas A2 inference products

×

Atlas 200I/500 A2 inference products

×

Atlas inference products

×

Atlas training products

×

Function Usage

Performs model inference based on the attributes configured using the aclmdlSetExecConfigOpt API until the inference result is returned. This API is enhanced based on aclmdlExecuteAsync. It allows you to control configuration parameters during model inference. This API is asynchronous.

This API must be used together with other APIs to implement model execution. The API call sequence is as follows:
  1. Call aclmdlCreateExecConfigHandle to create a configuration object for model execution.
  2. Call aclmdlSetExecConfigOpt multiple times to set the value of each attribute in the configuration object.
  3. Call aclmdlExecuteAsyncV2 to specify the configuration information required for model execution and execute the model.
  4. After the model is successfully executed, call aclmdlDestroyExecConfigHandle to destroy the configuration object.

Prototype

1
aclError aclmdlExecuteAsyncV2(uint32_t modelId, const aclmdlDataset *input, aclmdlDataset *output, aclrtStream stream, const aclmdlExecConfigHandle *handle)

Parameters

Parameter

Input/Output

Description

modelId

Input

Model ID for inference.

A successful aclmdlLoadFromFile, aclmdlLoadFromMem, aclmdlLoadFromFileWithMem, or aclmdlLoadFromMemWithMem call returns a model ID.

input

Input

Pointer to the input data for model inference. For the type definition, see aclmdlDataset.

output

Output

Pointer to the output data for model inference. For the type definition, see aclmdlDataset.

stream

Input

Stream. For the type definition, see aclrtStream.

handle

Input

Pointer to the configuration object for model execution. For the type definition, see aclmdlExecConfigHandle.

The value must be the same as that of handle in aclmdlSetExecConfigOpt.

Returns

0 on success; else, failure. For details, see aclError.

Restrictions

The restrictions are the same as those of aclmdlExecuteAsync.