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

#### 产品支持情况

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


#### 功能说明

设置黑电平属性。


#### 函数原型

```
hi_s32
hi_mpi_isp_set_black_level_attr(
hi_vi_pipe
vi_pipe, const
hi_isp_black_level_attr
*black_level)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| vi\_pipe | 输入 | VI PIPE号。 取值范围：[0, 12)。 |
| black\_level | 输入 | 黑电平属性。 |


#### 返回值说明

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


#### 约束说明

- 如果接口配置为自动模式：若cmos.c里面的ISP_CMOS_BLACK_LEVEL_S结构体成员bUpdate设置为HI_TRUE，则表示始终使用cmos.c内联动的黑电平配置，而bUpdate设置为HI_FALSE，则表示使用cmos.c非联动的黑电平配置；如果接口配置为手动模式：此时接口配置的黑电平配置会生效，ISP内部采用接口配置值。
- 线性模式下，black level模块集成在isp dgain模块中，所以bypass isp dgain会同时关闭isp dgain模块中的black level功能。对图像质量影响较大。
- WDR模式下，black level模块集成在isp dgain及WDR模块中，bypass isp dgain也会对图像质量有部分影响。