aclrtMemcpyFromSymbol
产品支持情况
产品 |
是否支持 |
|---|---|
√ |
|
√ |
|
√ |
|
☓ |
|
√ |
|
☓ |
功能说明
实现Device变量数据到Host的同步内存复制，以便读取Device变量中的数据。
函数原型
1 | aclError aclrtMemcpyFromSymbol(void *dst, size_t dstMax, const void *symbol, size_t count, size_t offset, aclrtMemcpyKind kind) |
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
dst |
输入 |
目的内存地址指针。 |
dstMax |
输入 |
dst内存最大长度，单位Byte。 需满足dstMax≥count。 |
symbol |
输入 |
Device变量的地址。 此处的Device变量通过__gm__方式声明的变量。 |
count |
输入 |
内存复制的长度，单位Byte。 需满足 offset + count ≤ Device变量大小，Device变量大小可通过aclrtGetSymbolSize接口查询获取。 |
offset |
输入 |
Device变量地址偏移，单位Byte。 需满足 offset + count ≤ Device变量大小，Device变量大小可通过aclrtGetSymbolSize接口查询获取。 |
kind |
输入 |
内存复制的类型。类型定义请参见aclrtMemcpyKind。 本接口仅支持ACL_MEMCPY_DEVICE_TO_HOST和ACL_MEMCPY_DEFAULT。 |
返回值说明
返回0表示成功，返回其他值表示失败，请参见aclError。
约束说明
与aclrtGetSymbolAddress接口中的约束保持一致。
父主题： Device变量内存操作