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

#### 产品支持情况

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


#### 功能说明

设置白平衡属性。


#### 函数原型

```
hi_s32
hi_mpi_isp_set_wb_attr(
hi_vi_pipe
vi_pipe, const
hi_isp_wb_attr
*wb_attr)
```


#### 参数说明

| 参数名称 | 输入/输出 | 描述 |
| --- | --- | --- |
| vi\_pipe | 输入 | VI PIPE号。 取值范围：[0, 12)。 |
| wb\_attr | 输入 | 白平衡的参数属性 |


#### 返回值说明

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


#### 约束说明

- 白平衡控制类型为自动时，AWB算法自动调节白平衡系数。
- 白平衡控制类型为手动时，AWB算法失效，需自行设定Rgain、Ggain、Bgain。
  环境色温、照度会影响白点的分布范围，AWB算法在运行过程中，会根据环境参数自动刷新AWB Bayer域统计信息的白点参数。用户希望在AWB算法运行时修改AWB统计参数，需要调用hi_mpi_isp_set_wb_attr接口，关闭统计参数自动刷新功能。用户关闭统计参数自动刷新功能，到ISP收到配置并响应，有2帧的延时。因此，用户设置后需要等待2帧时间再修改AWB统计参数。
