hi_mpi_rgn_create

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	x
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	x
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	x
Atlas 训练系列产品	x
Atlas 200/300/500 推理产品	x

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

创建不同类型的区域。

hi_s32 hi_mpi_rgn_create(hi_rgn_handle handle, const hi_rgn_attr *rgn_attr)

参数名	输入/输出	说明
handle	输入	区域句柄号。必须是未使用的handle号，由用户指定，意义等同于ID号。取值范围：[0, 1024)。
rgn_attr	输入	区域属性指针，不能为空。当前仅支持创建COVER、MOSAIC、OVERLAYEX类型的区域。其它区域属性，如区域位置、层次等，需调用hi_mpi_rgn_attach_to_chn接口时指定。

参数名

输入/输出

说明

handle

输入

区域句柄号。

必须是未使用的handle号，由用户指定，意义等同于ID号。

取值范围：[0, 1024)。

rgn_attr

输入

区域属性指针，不能为空。

当前仅支持创建COVER、MOSAIC、OVERLAYEX类型的区域。其它区域属性，如区域位置、层次等，需调用hi_mpi_rgn_attach_to_chn接口时指定。

不支持重复创建。
创建区域时，本接口只进行基本的参数的检查，譬如：最小宽高，最大宽高等；当调用hi_mpi_rgn_attach_to_chn接口将区域叠加到通道上时，根据各通道模块支持类型的约束条件进行更加有针对性的参数检查，譬如支持的像素格式等。

父主题： Region区域管理