---
title: aclvencSendFrame
description: "将待编码的图片传到编码器进行编码。异步接口。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0717.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0717.html
indexId: b0d7fa69b4217a18c56943768fca00ad85a0f34da9fa8cfc511cc72c672f6d55105
---
# aclvencSendFrame

#### 函数功能

将待编码的图片传到编码器进行编码。异步接口。


#### 约束说明

- 发送数据前必须保证通道已经被创建，否则返回错误。
- 不能发送eos为0的空码流包（码流长度为0或码流地址为空）。
- 结束视频编码时可以发送eos为1的空图片，表示当前编码结束。
- 编码时，输入内存需要在  aclvencCallback
回调函数内获取结果之后才能进行释放。


#### 函数原型

aclError aclvencSendFrame(aclvencChannelDesc *channelDesc,

acldvppPicDesc *input,

void *reserve,

aclvencFrameConfig *config,

void *userdata)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| channelDesc | 输入 | 通道描述信息的指针。 与调用aclvencCreateChannel接口创建通道时指定的channelDesc保持一致。 在通道描述信息中指定视频编码的回调函数。 |
| input | 输入 | 输入图片描述信息的指针，输入内存用户需提前申请。 调用acldvppCreatePicDesc接口创建图片描述信息，调用acldvppSetPicDesc系列接口设置图片描述参数（例如，宽、高等）。 输入图片格式以通道描述信息中设置的格式为准，调用acldvppSetPicDescFormat接口设置输入图片格式无效。 输入图片的分辨率、格式的要求，请参见功能及约束说明。 |
| reserve | 输入 | 预留参数，暂不使用。 |
| config | 输入 | 单帧配置数据的指针。 |
| userdata | 输入 | 用户自定义数据的指针。 |


#### 返回值说明

返回0表示成功，返回非0表示失败。


#### 参考资源

接口调用流程及示例，参见VENC视频编码。