aclmdlExecuteV2

函数功能

根据aclmdlSetExecConfigOpt接口所配置的属性，执行模型推理，直到返回推理结果。该接口是在aclmdlExecute接口基础上进行了增强，支持在执行模型推理时控制Stream任务的超时时间、Event任务的超时时间。

约束说明

本接口需要配合其它接口一起使用，实现模型执行，接口调用顺序如下：
1. 调用aclmdlCreateExecConfigHandle接口创建模型执行的配置对象。
2. 多次调用aclmdlSetExecConfigOpt接口设置配置对象中每个属性的值。
3. 调用aclmdlExecuteV2接口指定模型执行时需要的配置信息，并进行模型执行。
4. 模型执行成功后，调用aclmdlDestroyExecConfigHandle接口销毁。
其他约束与aclmdlExecute一致。

函数原型

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

参数说明

参数名

输入/输出

说明

modelId

输入

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

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

input

输入

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

output

输出

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

调用aclCreateDataBuffer接口创建存放对应index输出数据的aclDataBuffer类型时，支持在data参数处传入nullptr，同时size需设置为0，表示创建一个空的aclDataBuffer类型，然后在模型执行过程中，系统内部自行计算并申请该index输出的内存。使用该方式可节省内存，但内存数据使用结束后，需由用户释放内存并重置aclDataBuffer，同时，系统内部申请内存时涉及内存拷贝，可能涉及性能损耗。

释放内存并重置aclDataBuffer的示例代码如下：

aclDataBuffer *dataBuffer = aclmdlGetDatasetBuffer(output, 0); // 根据index获取对应的dataBuffer        
void *data = aclGetDataBufferAddr(dataBuffer);  // 获取data的Device指针
aclrtFree(data ); // 释放Device内存
aclUpdateDataBuffer(dataBuffer, nullptr, 0); // 重置dataBuffer里面内容，以便下次推理

stream

输入

指定Stream。

若此处传NULL，则通过aclmdlSetExecConfigOpt接口配置的属性值不生效。

handle

输入

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

返回值说明

返回0表示成功，返回其他值表示失败。

父主题： 模型执行