---
title: hi_mpi_venc_get_roi_attr
description: "获取H.264/H.265通道的ROI配置属性。关于ROI编码功能的详细说明请参见ROI编码功能说明。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_1069.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_1069.html
indexId: e974b3dc92f83803fbc828d36662974d5ca888ec1130c3bbfcacd040bc44db37105
---
# hi_mpi_venc_get_roi_attr

#### 函数功能

获取H.264/H.265通道的ROI配置属性。关于ROI编码功能的详细说明请参见ROI编码功能说明。


#### 约束说明

- 本接口用于获取H.264/H.265协议编码通道的指定索引号的ROI配置。


- 本接口在编码通道创建之后，编码通道销毁之前调用。

- 建议用户在创建通道之后，启动编码之前调用此接口，减少在编码过程中调用的次数。

#### 函数原型

hi_s32 hi_mpi_venc_get_roi_attr(hi_venc_chn chn, hi_u32 idx, hi_venc_roi_attr *roi_attr)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| chn | 输入 | 编码通道号。 Atlas 200/500 A2推理产品，编码通道号的取值范围：[0, 128)，JPEGE功能和VENC功能共用通道，且通道总数最多128。 |
| idx | 输入 | H.264/H.265协议编码通道ROI区域索引。 |
| roi\_attr | 输出 | ROI区域参数指针。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  VENC视频编码/JPEGE图片编码返回码