HixlCSClientGetRemoteMem

函数功能

获取Server已注册的内存信息。

函数原型

HixlStatus HixlCSClientGetRemoteMem(HixlClientHandle client_handle,
                                    CommMem **remote_mem_list,
                                    char ***mem_tag_list,
                                    uint32_t *list_num,
                                    uint32_t timeout_ms);

参数说明

参数名	输入/输出	描述
client_handle	输入	客户端句柄。
remote_mem_list	输出	返回的CommMem数组指针。
mem_tag_list	输出	字符串数组，对应每个CommMem的标签。
list_num	输出	返回的列表长度。
timeout_ms	输入	请求超时时间（单位：毫秒）。

返回值

HIXL_SUCCESS：成功
HIXL_PARAM_INVALID：参数错误
其他：失败或超时

约束说明

输出参数的内存生命周期由接口内部管理。重复调用该接口，将释放上一次申请的内存，如有需要请按需拷贝至本地内存定义，详细信息请参考 https://gitcode.com/cann/hcomm/blob/master/include/hcomm_res_defs.h。
调用HixlCSClientConnect接口后，需要调用该接口，确保远端内存描述信息交换至本地。

父主题： 接口说明