昇腾社区首页
中文
注册
开发者
下载

aclrtLaunchKernelV2

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

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

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

功能说明

指定任务下发的配置信息,并启动对应算子的计算任务。异步接口。

函数原型

aclError aclrtLaunchKernelV2(aclrtFuncHandle funcHandle, uint32_t blockDim, const void *argsData, size_t argsSize, aclrtLaunchKernelCfg *cfg, aclrtStream stream)

参数说明

参数名

输入/输出

说明

funcHandle

输入

核函数句柄。

blockDim

输入

指定核函数将会在几个核上执行。

argsData

输入

存放核函数所有入参数据的Device内存地址指针。

内存申请接口请参见内存管理

注意,执行本接口下发任务的Device需与argsData中使用的Device内存要是同一个Device。

argsSize

输入

argsData参数值的大小,单位为Byte。

cfg

输入

任务下发的配置信息。

不指定配置时,此处可传NULL。

stream

输入

指定执行任务的Stream。

返回值说明

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

参考资源

下表的几个接口都用于启用对应算子的计算任务,但功能和使用方式有所不同:

接口

核函数参数值的传入方式

核函数参数值的存放位置

是否可指定任务下发的配置信息

aclrtLaunchKernel

在接口中指定存放核函数所有入参数据的Device内存地址指针

Device内存

aclrtLaunchKernelV2

在接口中指定存放核函数所有入参数据的Device内存地址指针

Device内存

aclrtLaunchKernelWithConfig

在接口中指定参数列表句柄aclrtArgsHandle

Host内存

aclrtLaunchKernelWithHostArgs

在接口中指定存放核函数所有入参数据的Host内存地址指针

Host内存