acldvppJpegEncodeAsync
函数功能
将YUV格式图片编码成.jpg图片,异步接口。
约束说明
该接口是异步接口,调用接口成功仅表示任务下发成功,不表示任务执行成功。调用该接口后,需调用同步等待接口(例如,aclrtSynchronizeStream)确保任务已执行完成,否则可能会导致训练或推理等业务异常、Device断链掉卡等未知情况。
函数原型
aclError acldvppJpegEncodeAsync(acldvppChannelDesc *channelDesc,
acldvppPicDesc *inputDesc,
const void *data,
uint32_t *size,
acldvppJpegeConfig *config,
aclrtStream stream);
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
channelDesc |
输入 |
通道描述信息的指针。 与调用acldvppCreateChannel接口创建通道时指定的channelDesc保持一致。 |
inputDesc |
输入 |
输入图片描述信息的指针。
|
data |
输出 |
输出内存地址的指针,存放编码后的数据。 |
size |
输入&输出 |
输出内存大小的指针,单位Byte。 size作为输入参数时,可提前调用acldvppJpegPredictEncSize接口预估输出内存大小。 size作为输出参数时,表示实际输出内存大小,可能与调用acldvppJpegPredictEncSize接口预估的内存大小存在差异,如果用户需要取用编码后的数据,请使用实际输出内存大小。 |
config |
输入 |
图片编码配置数据的指针。 调用acldvppCreateJpegeConfig接口创建图片编码配置数据,调用acldvppSetJpegeConfigLevel接口设置编码配置数据。 |
stream |
输入 |
指定Stream。 |
返回值说明
返回0表示任务下发成功,返回非0表示任务下发失败。