# hi_mpi_vi_send_pipe_raw

#### 函数功能

通过VI PIPE发送RAW数据。


#### 约束说明

- 调用本接口前，必须先依次调用  hi_mpi_vi_create_pipe
接口创建PIPE、调用  hi_mpi_vi_start_pipe
接口启动PIPE，在调用  hi_mpi_vi_create_pipe
接口创建PIPE时，PIPE属性的isp_bypass必须为HI_FALSE。
- 发送RAW数据前，需要先调用  hi_mpi_vi_set_pipe_frame_source
接口将PIPE的数据来源设置为HI_VI_PIPE_FRAME_SOURCE_USER，此时来自SENSOR的数据不再会送给ISP BE处理，ISP BE只会处理用户送下来的帧数据。
- WDR模式下，每个PIPE的RAW在frame_info存放的顺序必须与  hi_mpi_vi_set_dev_bind_pipe
接口绑定PIPE时的顺序保持一致，目的是保证长短曝光帧的顺序正确，每个PIPE的RAW的属性(宽高，像素格式，压缩等等)要与  hi_mpi_vi_create_pipe
接口创建时保持一致。
- 通过本接口发送RAW数据时，对RAW数据有如下要求：

  - 送下来的RAW帧信息必须为真实有效的通过    hi_mpi_vi_pipe_get_buffer
接口获取的帧信息。
  - RAW数据像素格式及图像大小必须与    hi_mpi_vi_create_pipe
接口创建PIPE时设置的像素格式及图像大小保持一致。
  - RAW数据field必须为HI_VIDEO_FIELD_FRAME。
  - RAW数据video_format必须为HI_VIDEO_FORMAT_LINEAR。
  - RAW数据compress_mode仅支持HI_COMPRESS_MODE_NONE、HI_COMPRESS_MODE_LINE、HI_COMPRESS_MODE_FRAME。
  - RAW数据动态范围dynamic_range必须为HI_DYNAMIC_RANGE_SDR8。


#### 函数原型

hi_s32 hi_mpi_vi_send_pipe_raw(hi_u32 pipe_num, hi_vi_pipe pipe_id[], const hi_video_frame_info *frame_info[], hi_s32 milli_sec)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| pipe\_num | 输入 | PIPE数量。 当工作模式为线性模式时，该参数取值为 1；当工作模式为WDR模式时，该参数取值需要与WDR的PIPE数相同。具体模式可通过hi\_mpi\_vi\_set\_dev\_attr接口设置WDR属性配置。 |
| pipe\_id | 输入 | PIPE号数组，数组内的元素个数与pipe\_num参数值保证一致。 |
| frame\_info | 输入 | RAW数据信息。 |
| milli\_sec | 输入 | 超时参数 ，取值范围： \-1：表示阻塞模式； 0：表示非阻塞模式； >0： 配置具体的超时时间，单位为毫秒（ms）。 |


#### 返回值说明

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


#### 参考资源

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