---
title: hi_mpi_isp_set_iris_attr
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevapi_0180.html
sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevapi_0180.html
indexId: 0a7a48a7809748937031d6ba1cb6d553a17dbe5ab4c83ecd8a9f3848f274f4f265
---
# hi_mpi_isp_set_iris_attr

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | ☓ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | ☓ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | ☓ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | ☓ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

设定光圈的控制属性，该函数可实现手动光圈属性和光圈类型等参数的设置。


#### 函数原型

```
hi_s32
hi_mpi_isp_set_iris_attr(
hi_vi_pipe
vi_pipe, const
hi_isp_iris_attr
*iris_attr)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| vi\_pipe | 输入 | VI PIPE号。 取值范围：[0, 12)。 |
| iris\_attr | 输入 | 光圈控制属性结构体指针。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  ISP返回码
。


#### 约束说明

- 根据实际对接镜头光圈类型，设置正确的光圈类型属性，由此再去设置相关的DC-Iris/P-Iris控制属性。若对接的是手动光圈镜头，可将光圈类型设置为HI_ISP_IRIS_DC_TYPE，建议此时关闭AI使能。
- 手动光圈属性主要用于调试，可通过该MPI进行设置。对于P-Iris镜头，手动iris_fno值会受到最大、最小光圈目标值的影响。自动光圈属性的更多参数需要调用hi_mpi_isp_set_dciris_attr和hi_mpi_isp_get_piris_attr进行设置。