---
title: 函数：dvpp_jpeg_encode_async
description: "| C函数原型 | aclError acldvppJpegEncodeAsync(acldvppChannelDesc \*channelDesc, acldvppPicDesc \*inputDesc, const void \*data, uint32\_t \*size, acldvppJpegeConfig \*config, aclrtStream stream) |"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgp/aclpythondevg_01_0318.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgp/aclpythondevg_01_0318.html
indexId: 05cd0289005bfa70f3a1d0c99e5d7f61ff2a43fcde69aabe486b85a272c0286b108
---
# 函数：dvpp_jpeg_encode_async

| C函数原型 | aclError acldvppJpegEncodeAsync(acldvppChannelDesc \*channelDesc, acldvppPicDesc \*inputDesc, const void \*data, uint32\_t \*size, acldvppJpegeConfig \*config, aclrtStream stream) |
| --- | --- |
| Python函数 | ret = acl.media.dvpp\_jpeg\_encode\_async(dvpp\_channel\_desc, input\_dvpp\_pic\_desc, data, size\_ptr, dvpp\_jpege\_config, stream) |
| 函数功能 | 将YUV格式图片编码成.jpg图片，异步接口。 |
| 输入说明 | dvpp\_channel\_desc：int，指定通道描述信息的指针地址，与调用acl.media.dvpp\_create\_channel接口创建通道时指定的dvpp\_channel\_desc保持一致。 input\_dvpp\_pic\_desc：int，输入图片描述信息的指针地址。 调用acl.media.dvpp\_create\_pic\_desc接口创建图片描述信息。 调用acl.media.dvpp\_set\_pic\_desc系列接口设置图片描述参数（例如，图片格式、宽、高等）。 输入图片分辨率（≤通道的最大宽度\*高度）、图像格式的要求，请参见功能及约束说明。 data：int，输出内存地址的指针地址，存放编码后的数据。 size\_ptr：int，指向输出内存大小的指针地址，内存大小单位Byte。 可提前调用acl.media.dvpp\_jpeg\_predict\_enc\_size接口预估输出内存大小out\_buffer\_size。 调用np\_out\_size = np.array([out\_buffer\_size], dtype=np.int32)创建numpy array类型数据。再调用bytes\_data = np\_out\_size.tobytes()\-> \\->size\_ptr = acl.util.bytes\_to\_ptr(bytes\_data)，将数据转换为对象作为入参。 注意：函数调用成功后，size\_ptr指向的数据（即np\_out\_size）会发生改变。 dvpp\_jpege\_config：int，表示图片编码配置数据的指针地址。 调用acl.media.dvpp\_create\_jpege\_config接口创建图片编码配置数据，调用acl.media.dvpp\_set\_jpege\_config\_level接口设置编码配置数据。 stream：int，指定Stream对象。 |
| 返回值说明 | ret：int，错误码。 返回0，表示任务下发成功。 返回非0，表示任务下发失败。 |
| 参考资源 | 接口调用流程及示例，参见JPEGE图片编码。 |