---
title: 函数：dvpp_vpc_convert_color_async
description: "| C函数原型 | aclError acldvppVpcConvertColorAsync(acldvppChannelDesc \*channelDesc, acldvppPicDesc \*inputDesc, acldvppPicDesc \*outputDesc, aclrtStream stream) |"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgp/aclpythondevg_01_0295.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgp/aclpythondevg_01_0295.html
indexId: 7c64918bb423ce89bfd1b235ee6f33e342ddbd021e2bc5b38f5cbbd7b47b6a1b108
---
# 函数：dvpp_vpc_convert_color_async

| C函数原型 | aclError acldvppVpcConvertColorAsync(acldvppChannelDesc \*channelDesc, acldvppPicDesc \*inputDesc, acldvppPicDesc \*outputDesc, aclrtStream stream) |
| --- | --- |
| Python函数 | ret = acl.media.dvpp\_vpc\_convert\_color\_async(dvpp\_channel\_desc, input\_dvpp\_pic\_desc, output\_dvpp\_pic\_desc, stream) |
| 函数功能 | 转换图片的格式，输出图片的宽高须与输入图片的宽高一致。异步接口。 |
| 输入说明 | 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系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 output\_dvpp\_pic\_desc：int，输出图片信息。 作为输入时，需要用户调用如下接口： 调用acl.media.dvpp\_create\_pic\_desc接口创建图片描述信息。 调用acl.media.dvpp\_set\_pic\_desc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。 需指定输出图片的宽、高、宽stride、高stride、内存地址、内存大小、格式等。 配置输出图片的宽、高时，需与输入图片的宽、高保持一致，否则会返回报错。 如果将输出图片的宽或高配置为0，则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高；同时，VPC内部会按对齐要求计算宽stride、高stride，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。 配置输出图片的宽stride、高stride时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。 stream：int，指定Stream对象的。 |
| 返回值说明 | ret：int，错误码。 返回0表示任务下发成功。 返回非0表示任务下发失败。 |
| 约束说明 | 输入、输出图片分辨率为10\*6~4096\*4096（包括4096）。 输入、输出图片的格式请参见图片格式、宽高对齐、内存约束。 |