Atlas系列硬件: Atlas 200l DK A2 开发者套件; Atlas 200l DK 开发者套件（型号：3000）; 加速模块、加速卡、智能小站、服务器、集群

异构计算架构: CANN社区版; CANN商用版

AI框架: MindSpore; TensorFlow框架模型（社区版）; TensorFlow框架模型（商用版）; PyTorch框架适配

昇腾推理引擎: MindIE

应用使能MindX: MindX DL; MindX Edge; MindX SDK

全流程开发工具: MindStudio

hi_mpi_rgn_get_canvas_info

Atlas 200/300/500 推理产品，不支持该接口。

Atlas 训练系列产品，不支持该接口。

Atlas 推理系列产品（Ascend 310P处理器），不支持该接口。

Atlas A2训练系列产品/Atlas 800I A2推理产品，不支持该接口。

Atlas 200/500 A2推理产品，Ascend EP标准形态下，不支持使用该接口。

函数功能

获取区域的显示画布信息。

约束说明

区域必须已创建。
主要用于OVERLAYEX类型导入位图数据。
本接口用于获取区域对应的画布信息，在得到画布地址之后，用户可直接对画布进行操作，譬如：将bmp数据直接填写到该画布中。然后通过调用hi_mpi_rgn_update_canvas接口更新显示画布数据。

函数原型

hi_s32 hi_mpi_rgn_get_canvas_info(hi_rgn_handle handle, hi_rgn_canvas_info *canvas_info)

参数说明

参数名

输入/输出

说明

handle

输入

区域句柄号。

取值范围：[0, 1024)。

canvas_info

输出

区域显示画布信息。

返回值说明

0：获取数据成功
非0：失败，参见19.18.5-区域管理返回码

参考资源

接口调用流程，参见NVR场景视频解码、处理和显示。

父主题： Region区域管理