---
title: 函数：memset_async
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0119.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0119.html
indexId: 11bed973e6c9ab261ab50669783571a736b94502f6a4e46db3a97608ad3875b071
---
# 函数：memset_async

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

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

待初始化的内存支持在Host侧或Device侧，系统根据地址判定是Host还是Device。如果Host内存不是用acl接口（例如acl.rt.malloc_host）申请的，将会导致未定义的行为。


#### 函数原型

- 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断链掉卡等未知情况。