# hi_mpi_rgn_create

#### 函数功能

创建不同类型的区域。


#### 约束说明

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


#### 函数原型

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接口时指定。 |


#### 返回值说明

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


#### 参考资源

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