开发者
资源

HixlCSServerRegMem

函数功能

Server注册共享内存,该内存供Client访问。

函数原型

HixlStatus HixlCSServerRegMem(HixlServerHandle server_handle,
                              const char *mem_tag,
                              const CommMem *mem,
                              MemHandle *mem_handle);

参数说明

参数名

输入/输出

描述

server_handle

输入

Server实例句柄。

mem_tag

输入

内存标签字符串,用于标识此内存。可选,可传入为NULL。

mem

输入

指向CommMem,描述内存位置与大小(定义请参考 https://gitcode.com/cann/hcomm/blob/master/include/hcomm_res_defs.h )。

mem_handle

输出

返回的内存句柄,用于后续注销。

返回值

  • HIXL_SUCCESS:注册成功
  • HIXL_PARAM_INVALID:参数错误
  • 其他:失败

约束说明

  • 在Client调用HixlCSClientConnect与本端建链之前需要完成所有本地内存的注册。
  • 使用host RoCE网卡当前不支持注册“aclrtMallocHost”申请出来的内存,可使用malloc等方式。
  • 注册Device的内存需要使用“aclrtMalloc”进行申请。