acldvppVpcConvertColorAsync

转换图片的格式，输出图片的宽高须与输入图片的宽高一致。

本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，aclrtSynchronizeStream）确保任务已执行完成，否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。

aclError acldvppVpcConvertColorAsync(acldvppChannelDesc *channelDesc,
acldvppPicDesc *inputDesc,
acldvppPicDesc *outputDesc,
aclrtStream stream)

参数名	输入/输出	说明
channelDesc	输入	通道描述信息的指针。与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。
inputDesc	输入	输入图片信息的指针。调用acldvppCreatePicDesc接口创建图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。
outputDesc	输入&输出	输出图片信息的指针。 outputDesc参数作为输入时，需要用户调用如下接口：调用acldvppCreatePicDesc接口创建图片描述信息。调用acldvppSetPicDesc系列接口设置图片描述参数（例如，内存地址、内存大小、图片格式、宽、高等）。需指定输出图片的宽、高、宽stride、高stride、内存地址、内存大小、格式等。配置输出图片的宽、高时，需与输入图片的宽、高保持一致，否则会返回报错。如果将输出图片的宽或高配置为0，则VPC内部会将输入图片的宽、高分别作为输出图片的宽、高；同时，VPC内部会按对齐要求计算宽stride、高stride，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。配置输出图片的宽stride、高stride时，满足对齐要求即可，不同图片格式的对齐要求不同，请参见图片格式、宽高对齐、内存约束。
stream	输入	指定Stream。

返回0表示任务下发成功，返回非0表示任务下发失败，请参见aclError。

接口调用示例，参见格式转换示例代码。

父主题： VPC图像处理功能