昇腾社区首页
中文
注册

函数:memset_async

产品支持情况

产品

是否支持

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

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas 训练系列产品

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

功能说明

初始化内存,将内存中的内容设置为指定的值,异步接口。

待初始化的内存支持在Host侧或Device侧,系统根据地址判定是Host还是Device。

函数原型

  • C函数原型
    1
    aclError aclrtMemsetAsync(void *devPtr, size_t maxCount, int32_t value, size_t count, aclrtStream stream)
    
  • python函数
    1
    ret = acl.rt.memset_async(dev_ptr, max_count, value, count, stream)
    

参数说明

参数名

说明

dev_ptr

int,内存的起始地址。

max_count

int,内存的最大长度,单位Byte。

value

int,设置的值。

count

int,需要设置为指定值的内存长度,单位Byte。

stream

int,指定Stream的指针地址。

返回值说明

返回值

说明

ret

int,错误码,返回0表示成功,返回其它值表示失败。

约束说明

该接口是异步接口,调用接口成功仅表示任务下发成功,不表示任务执行成功。调用该接口后,必须调用同步等待接口(例如,acl.rt.synchronize_stream)确保内存初始化的任务已执行完成,否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。