# hi_mpi_vi_set_pipe_frame_dump_attr

#### 函数功能

设置VI 物理PIPE dump属性。


#### 约束说明

- 调用本接口前，必须先调用  hi_mpi_vi_create_pipe
接口创建PIPE。

- 需要dump不同的像素格式数据，可以在dump前调用  hi_mpi_vi_create_pipe
接口创建pipe时指定像素格式，像素格式需要与sensor模组实际输出的格式对齐。
- 需要dump裁剪后的图像，可以在dump前调用  hi_mpi_vi_set_pipe_pre_crop
接口设置pipe的裁剪。
- 需要dump压缩或者非压图像，可以在dump前调用  hi_mpi_vi_create_pipe
接口创建pipe时指定压缩类型。
- 不支持虚拟PIPE。
- 当pipe已经通过hi_mpi_vi_start_pipe接口启动后再调用当前接口，会清除内部缓存的用户未通过hi_mpi_vi_get_pipe_frame接口取走的图像。


#### 函数原型

hi_s32 hi_mpi_vi_set_pipe_frame_dump_attr(hi_vi_pipe vi_pipe, const hi_vi_frame_dump_attr *dump_attr)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| vi\_pipe | 输入 | 物理PIPE号。 取值范围：[0, 4)。 |
| dump\_attr | 输入 | VI 物理PIPE dump的属性。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  VI视频输入返回码
。


#### 参考资源

接口调用流程，参见视频数据获取功能。
