aclrtMemcpyAsync
产品支持情况
|
产品 |
是否支持 |
|---|---|
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
功能说明
实现内存复制。
本接口中的Host内存支持锁页内存（例如通过aclrtMallocHost接口申请的内存）、非锁页内存（通过malloc接口申请的内存）。当Host内存是非锁页内存时，本接口在内存复制任务完成后才返回；当Host内存是锁页内存时，本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功，调用本接口后，需调用同步等待接口（例如，aclrtSynchronizeStream）确保内存复制的任务已执行完成。
函数原型
aclError aclrtMemcpyAsync(void *dst, size_t destMax, const void *src, size_t count, aclrtMemcpyKind kind, aclrtStream stream)
参数说明
|
参数名 |
输入/输出 |
说明 |
|---|---|---|
|
dst |
输入 |
目的内存地址指针。 |
|
destMax |
输入 |
目的内存地址的最大内存长度，单位Byte。 |
|
src |
输入 |
源内存地址指针。 |
|
count |
输入 |
内存复制的长度，单位Byte。 |
|
kind |
输入 |
内存复制的类型。 |
|
stream |
输入 |
指定执行内存复制任务的Stream。 |
返回值说明
返回0表示成功，返回其他值表示失败，请参见aclError。
约束说明
|
型号 |
约束 |
|---|---|
|
各型号通用 |
|
|
|
|
|
|
|
|
|
本接口不支持异步Host内的内存复制功能，若传入的kind为ACL_MEMCPY_HOST_TO_HOST时，接口返回报错ACL_ERROR_RT_FEATURE_NOT_SUPPORT 。 |