Skip to main content

aclrtMallocHost

aclrtMemInvalidate​

函数功能​

将cache中的数据设置成无效。

该版本不需要用户处理cpu与npu之间的cache一致性，无需调用该接口。

函数原型​

aclError aclrtMemInvalidate(void *devPtr, size_t size)

参数说明​

参数名输入/输出说明
devPtr输入需要将其中cache数据置为无效的ddr内存起始地址指针。
size输入ddr内存大小，单位Byte。 size不能为0。

返回值说明​

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

父主题： 内存管理

aclrtFree​

函数功能​

释放Device上的内存，同步接口。

aclrtFree接口只能释放通过aclrtMalloc接口或aclrtMallocCached接口或aclrtMallocAlign32接口申请的内存。

函数原型​

aclError aclrtFree(void *devPtr)

参数说明​

参数名输入/输出说明
devPtr输入待释放内存的指针。

返回值说明​

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

参考资源​

接口调用示例，参见数据传输。

父主题： 内存管理

aclrtMallocHost​

函数功能​

应用在Host上运行时，调用该接口申请的是Host内存，由系统保证内存首地址64字节对齐。应用在Device上运行时，调用该接口申请的是Device内存，且Device上的内存按普通页申请，如需首地址64字节对齐，需要用户自行处理对齐。同步接口。

约束说明​

  • 使用aclrtMallocHost接口申请的内存，需要通过aclrtFreeHost接口释放内存。

  • 频繁调用aclrtMallocHost接口申请内存、调用aclrtFreeHost接口释放内存，会损耗性能，建议用户提前做内存预先分配或二次管理，避免频繁申请/释放内存。

  • 若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下需求：

    • 内存大小向上对齐成32整数倍+32字节（m=ALIGN_UP[len,32]+32字节）；
    • 内存起始地址需满足64字节对齐（ALIGN_UP[m,64]）。

    :::note 说明 len表示某段内存的大小，ALIGN_UP[len,k]表示向上按k字节对齐：((len-1)/k+1)*k。 :::

函数原型​

aclError aclrtMallocHost(void **hostPtr, size_t size)

参数说明​

参数名输入/输出说明
size输入申请内存的大小，单位Byte。 size不能为0。
hostPtr输出“已分配内存的指针”的指针。

返回值说明​

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

参考资源​

接口调用示例，参见数据传输。

父主题： 内存管理

aclrtFreeHost​

函数功能​

释放内存，同步接口。

aclrtFreeHost接口只能释放通过aclrtMallocHost接口申请的内存。

函数原型​

aclError aclrtFreeHost(void *hostPtr)

参数说明​

参数名输入/输出说明
hostPtr输入待释放内存的指针。

返回值说明​

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

参考资源​

接口调用示例，参见数据传输。

父主题： 内存管理

aclrtMemset​

函数功能​

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

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

函数原型​

aclError aclrtMemset (void *devPtr, size_t maxCount, int32_t value, size_t count)

参数说明​

参数名输入/输出说明
devPtr输入内存起始地址的指针。
maxCount输入内存的最大长度，单位Byte。
value输入设置的值。
count输入需要设置为指定值的内存长度，单位Byte。

返回值说明​

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

父主题： 内存管理

aclrtMemsetAsync​

函数功能​

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

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

约束说明​

该接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，一定要调用aclrtSynchronizeStream接口确保内存初始化的任务已执行完成。

函数原型​

aclError aclrtMemsetAsync(void *devPtr, size_t maxCount, int32_t value, size_t count, aclrtStream stream)

参数说明​

参数名输入/输出说明
devPtr输入内存起始地址的指针。
maxCount输入内存的最大长度，单位Byte。
value输入设置的值。
count输入需要设置为指定值的内存长度，单位Byte。
stream输入指定stream。

返回值说明​

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

父主题： 内存管理

在线提单