---
title: hi_vi_pipe_attr
description: "定义VI PIPE属性。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_1233.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_1233.html
indexId: 56761f8062f0e7c21129f46a62671ea4a178bd35481b5922f0be02806f10772a105
---
# hi_vi_pipe_attr

#### 说明

定义VI PIPE属性。


#### 定义

```
typedef struct {
hi_vi_pipe_bypass_mode
pipe_bypass_mode;
hi_bool
isp_bypass;
hi_size
size;
hi_pixel_format
pixel_format;
hi_compress_mode
compress_mode;
hi_data_bit_width
bit_width;
hi_frame_rate_ctrl
frame_rate_ctrl;
hi_u32
depth;
hi_u32
reserved[10];
} hi_vi_pipe_attr;
```


#### 成员

| 成员名称 | 描述 |
| --- | --- |
| pipe\_bypass\_mode | VI PIPE的bypass模式。静态属性，创建PIPE时设定，不可更改。 |
| isp\_bypass | ISP是否运行。静态属性，创建PIPE时设定，不可更改。 HI\_FALSE：ISP正常运行。 HI\_TRUE：ISP不运行。 当输入为Raw数据时，必须设置为HI\_FALSE；当输入为YUV时则可以设置为HI\_TRUE或者HI\_FALSE。 |
| size | 输入图像宽高。需根据所绑定的VI设备属性的宽高或调用hi\_mpi\_vi\_set\_pipe\_pre\_crop接口配置的宽高，保证大小一致，需与ISP公共属性所设置的宽高需保持一致。静态属性，创建PIPE时设定，不可更改。 取值范围：[120, 16384]。 |
| pixel\_format | 像素格式。静态属性，创建PIPE时设定，不可更改。 如果是YUV图像，则仅pipe2和pipe3支持，且仅支持输出HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_422、HI\_PIXEL\_FORMAT\_YVU\_SEMIPLANAR\_420、HI\_PIXEL\_FORMAT\_YUV\_400。 如果是RAW图像，则仅支持位宽为8、10、12、14的RGB BAYER格式。 |
| compress\_mode | 数据压缩格式。静态属性，创建PIPE时设定，不可更改。 仅支持帧压缩HI\_COMPRESS\_MODE\_FRAME或行压缩HI\_COMPRESS\_MODE\_LINE，且开启帧压缩时，分辨率需满足：总像素个数不少于307200个。 当输入数据格式为HI\_PIXEL\_FORMAT\_RGB\_BAYER\_10BPP、HI\_PIXEL\_FORMAT\_RGB\_BAYER\_12BPP、HI\_PIXEL\_FORMAT\_RGB\_BAYER\_14BPP时，线性模式、WDR帧模式和行模式都支持HI\_COMPRESS\_MODE\_LINE、HI\_COMPRESS\_MODE\_FRAME；当输入数据格式为格式为HI\_PIXEL\_FORMAT\_RGB\_BAYER\_8BPP时，不支持压缩；当输入数据格式为YUV时，不支持压缩。 |
| bit\_width | 输入图像的bit位宽。仅当像素格式pixel\_format为YUV像素格式时有效。静态属性，创建PIPE时设定，不可更改。 |
| frame\_rate\_ctrl | 帧率控制。 |
| depth | PIPE队列深度，用于缓存VI PIPE的临时数据、RAW/YUV图输入和输出数据。静态属性，创建 PIPE 时设定，不可更改。 临时缓存实际所能使用的最大队列深度为：hi\_vi\_pipe\_attr.depth \- hi\_vi\_frame\_dump\_attr.depth 取值范围：[0, 16]。 |
| reserved | 预留参数，为保证后续版本兼容性，请务必使用memset结构体方式进行清零初始化，在代码中必须避免显式对reserved字段进行访问。 |