昇腾社区首页
中文
注册

函数:host_register

C函数原型

aclError aclrtHostRegister(void *ptr, uint64_t size, aclrtHostRegisterType type, void **devPtr)

Python函数

dev_ptr, ret = acl.rt.host_register(ptr, size, type)

函数功能

将Host内存映射注册为Devcie可访问的地址,供Device侧网卡访问。映射后的Device地址不能用于内存复制操作。

本接口与acl.rt.host_unregister接口成对使用。

输入说明

ptr:int,Host内存地址。Host内存地址需4K页对齐。当os内核版本为5.10或更低时,使用非锁页内存会导致异常,因此必须调用acl.rt.malloc_host接口来申请Host内存;当os内核版本为5.10以上时,支持使用非锁页的Host内存,因此也支持不调用acl.rt.malloc_host接口申请Host内存。

size:int,内存大小,单位Byte。

type:int,内存注册类型。当前仅支持ACL_HOST_REGISTER_MAPPED,表示将Host内存映射注册为Devcie可访问的。

输出说明

dev_ptr:int,Host内存映射成的Device可访问的内存地址。

返回值说明

ret:int,返回0表示成功,返回其他值表示失败,请参见aclError