# hi_mpi_venc_send_jpege_frame

#### 函数功能

发送原始图像进行图像编码，并支持配置编码结果的输出内存地址。


#### 约束说明

- 在调用  hi_mpi_venc_create_chn
接口创建通道时，将参数hi_venc_chn_attr.venc_attr.buf_size参数值设置为0，本接口才有效，否则返回错误码HI_ERR_VENC_NOT_SUPPORT。
- JPEGE输入图像分辨率必须小于或等于编码通道的宽、高。
- 调用该接口发送图像，用户需要保证编码通道已创建且开启接收输入图片。
- 编码时，输入、输出内存均需要在调用  hi_mpi_venc_get_stream
接口获取结果之后才能进行释放。
- 图像编码，对输入、输出的约束请参见  JPEGE功能及约束说明
。


#### 函数原型

hi_s32 hi_mpi_venc_send_jpege_frame(hi_venc_chn chn, const hi_video_frame_info *frame, const hi_img_stream* jpege_stream, hi_s32 milli_sec)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| chn | 输入 | 编码通道号。 Atlas 200/500 A2推理产品，编码通道号的取值范围：[0, 128)，JPEGE功能和VENC功能共用通道，且通道总数最多128。 |
| frame | 输入 | 原始图像信息的指针。 |
| jpege\_stream | 输入 | 用于指定编码结果的输出内存地址和长度。 输出内存首地址需满足16字节对齐，内存大小可以调用hi\_mpi\_venc\_get\_jpege\_predicted\_size获取，再可调用hi\_mpi\_dvpp\_malloc接口申请输出内存。 |
| milli\_sec | 输入 | 超时时间，单位是毫秒。 \-1：阻塞方式 0：非阻塞方式 >0：超时方式，配置具体的超时时间。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的milli\_sec参数值为1，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。 |


#### 返回值说明

- 0：成功
- 非0：失败，参见  VENC视频编码/JPEGE图片编码返回码