昇腾社区首页
中文
注册

aclmdlExecuteAsyncV2

产品支持情况

产品

是否支持

Atlas A2 训练系列产品/Atlas 800I A2 推理产品

x

Atlas 200I/500 A2 推理产品

x

Atlas 推理系列产品

x

Atlas 训练系列产品

x

Atlas 200/300/500 推理产品

x

功能说明

本接口需要配合其它接口一起使用,实现模型执行,接口调用顺序如下:
  1. 调用aclmdlCreateExecConfigHandle接口创建模型执行的配置对象。
  2. 多次调用aclmdlSetExecConfigOpt接口设置配置对象中每个属性的值。
  3. 调用aclmdlExecuteAsyncV2接口指定模型执行时需要的配置信息,并进行模型执行。

    本接口是异步接口,调用接口成功仅表示任务下发成功,不表示任务执行成功。调用该接口后,需调用同步等待接口(例如,aclrtSynchronizeStream)确保任务已执行完成,否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。

  4. 模型执行成功后,调用aclmdlDestroyExecConfigHandle接口销毁。

函数原型

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

参数说明

参数名

输入/输出

说明

modelId

输入

指定需要执行推理的模型的ID。

调用aclmdlLoadFromFile接口/aclmdlLoadFromMem接口/aclmdlLoadFromFileWithMem接口/aclmdlLoadFromMemWithMem接口加载模型成功后,会返回模型ID。

input

输入

模型推理的输入数据的指针。

output

输出

模型推理的输出数据的指针。

stream

输入

指定Stream。

handle

输入

模型执行的配置对象的指针。与aclmdlSetExecConfigOpt中的handle保持一致。

返回值说明

返回0表示成功,返回其他值表示失败,请参见aclError

约束说明

约束与aclmdlExecuteAsync一致。