acldvppCreatePicDesc
acldvppSetChannelDescMode
函数功能
指定通道描述信息中的通道模式，明确图片数据处理通道用于实现哪种功能，目前支持VPC、JPEGD、JPEGE、PNGD功能。同步接口。
约束说明
接口调用顺序：acldvppCreateChannelDesc --> acldvppSetChannelDescMode --> acldvppCreateChannel
函数原型
aclError acldvppSetChannelDescMode(****acldvppChannelDesc *channelDesc, uint32_t mode)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| channelDesc | 输出 | 通道描述信息的指针。 需提前调用acldvppCreateChannelDesc接口创建acldvppChannelDesc类型的数据。 |
| mode | 输入 | 指定通道模式，各模式的取值请参见acldvppChannelMode枚举值。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： acldvppChannelDesc
acldvppSetChannelDescParam
函数功能
设置图片数据处理通道的属性参数接口。同步接口。
函数原型
aclError acldvppSetChannelDescParam**(acldvppChannelDesc *channelDesc, acldvppChannelDescParamType paramType, size_t length, const void *param)**
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| channelDesc | 输出 | 通道描述信息的指针。 需提前调用acldvppCreateChannelDesc接口创建acldvppChannelDesc类型的数据。 |
| paramType | 输入 | 属性参数的类型。 |
| length | 输入 | 属性参数值的字节数。 - 属性参数的类型为*_UINT64时，此处配置为8。 - 属性参数的类型为*_UINT32时，此处配置为4。 - 属性参数的类型为*_ENUM时，此处配置为4。 |
| param | 输入 | 属性参数值的指针。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： acldvppChannelDesc
acldvppGetChannelDescParam
函数功能
获取图片数据处理通道的属性参数接口。同步接口。
函数原型
aclError acldvppGetChannelDescParam**(const acldvppChannelDesc *channelDesc, acldvppChannelDescParamType paramType, size_t length, size_t *paramRetSize, void *param)**
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| channelDesc | 输入 | 通道描述信息的指针。 需提前调用acldvppCreateChannelDesc接口创建acldvppChannelDesc类型的数据，调用acldvppSetChannelDescParam接口设置通道属性值。 |
| paramType | 输入 | 属性参数的类型。 |
| length | 输入 | 属性参数值的字节数。 - 属性参数的类型为*_UINT64时，此处配置为8。 - 属性参数的类型为*_UINT32时，此处配置为4。 - 属性参数的类型为*_ENUM时，此处配置为4。 |
| paramRetSize | 输出 | 实际返回的属性参数值字节数的指针。 |
| param | 输出 | 属性参数值的指针。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： acldvppChannelDesc
acldvppCreatePicDesc
函数功能
创建acldvppPicDesc类型的数据，表示图片描述信息。同步接口。
如需销毁acldvppPicDesc类型的数据，请参见acldvppDestroyPicDesc。
函数原型
acldvppPicDesc *acldvppCreatePicDesc(****)
参数说明
无
返回值说明
- 返回acldvppPicDesc类型的指针，表示成功。
- 返回nullptr，表示失败。
父主题： acldvppPicDesc
acldvppSetPicDesc系列接口
函数功能
设置图片描述参数。同步接口。
函数原型
aclError acldvppSetPicDescData(acldvppPicDesc *picDesc, void *dataDev);
aclError acldvppSetPicDescSize(acldvppPicDesc *picDesc, uint32_t size);
aclError acldvppSetPicDescFormat(acldvppPicDesc *picDesc, acldvppPixelFormat format);
aclError acldvppSetPicDescWidth(acldvppPicDesc *picDesc, uint32_t width);
aclError acldvppSetPicDescHeight(acldvppPicDesc *picDesc, uint32_t height);
aclError acldvppSetPicDescWidthStride(acldvppPicDesc *picDesc, uint32_t widthStride);
aclError acldvppSetPicDescHeightStride(acldvppPicDesc *picDesc, uint32_t heightStride);
aclError acldvppSetPicDescRetCode(acldvppPicDesc *picDesc,uint32_t retCode)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| picDesc | 输出 | 描述图片信息的指针。 需提前调用acldvppCreatePicDesc接口创建acldvppPicDesc类型的数据。 |
| dataDev | 输入 | Device上图片数据内存的指针，必须是使用acldvppMalloc接口申请的内存。 |
| size | 输入 | 内存大小，单位Byte。 |
| format | 输入 | 图片格式。 |
| width | 输入 | 原始图片宽。 |
| height | 输入 | 原始图片高。 |
| widthStride | 输入 | 对齐后的宽。 |
| heightStride | 输入 | 对齐后的高。 |
| retCode | 输入 | 返回码（0成功，非0失败）。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： acldvppPicDesc
acldvppGetPicDesc系列接口
函数功能
获取图片描述信息**。**同步接口。
函数原型
void *acldvppGetPicDescData(const acldvppPicDesc *picDesc);
uint32_t acldvppGetPicDescSize(const acldvppPicDesc *picDesc);
acldvppPixelFormat acldvppGetPicDescFormat(const acldvppPicDesc *picDesc);
uint32_t acldvppGetPicDescWidth(const acldvppPicDesc *picDesc);
uint32_t acldvppGetPicDescHeight(const acldvppPicDesc *picDesc);
uint32_t acldvppGetPicDescWidthStride(const acldvppPicDesc *picDesc);
uint32_t acldvppGetPicDescHeightStride(const acldvppPicDesc *picDesc);
uint32_t acldvppGetPicDescRetCode(const acldvppPicDesc *picDesc)****;
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| picDesc | 输入 | 描述图片信息的指针。 需提前调用acldvppCreatePicDesc接口创建acldvppPicDesc类型的数据，调用acldvppSetPicDesc系列接口设置图片描述参数。 |
返回值说明
| 参数名 | 说明 |
|---|---|
| data | 图片数据的内存地址。 |
| size | 图片数据的内存的大小。 |
| format | 图片格式。 |
| width | 原始图片宽。 |
| height | 原始图片高。 |
| widthStride | 对齐后的宽。 |
| heightStride | 对齐后的高。 |
| retCode | 返回码（0成功，非0失败）。 VDEC解码时，用户需调用acldvppGetPicDescRetCode接口获取retCode返回码判断是否解码成功，如果解码失败，需要根据日志中的返回码判断具体的问题，返回码请参见返回码说明。retCode中部分返回码是以十六进制形式定义的，如用户在编码时以十进制打印返回码的值（例如，65540），则需提前转换为十六进制（例如，0x10004），然后在返回码说明中查询。 |
父主题： acldvppPicDesc
acldvppDestroyPicDesc
函数功能
销毁通过acldvppCreatePicDesc接口创建的acldvppPicDesc类型的数据。同步接口。
函数原型
aclError acldvppDestroyPicDesc(****acldvppPicDesc *picDesc)
参数说明
| 参数名 | 输入/输出 | 说明 |
|---|---|---|
| picDesc | 输入 | 待销毁的acldvppPicDesc类型指针。 |
返回值说明
返回0表示成功，返回其它值表示失败。
父主题： acldvppPicDesc
在线提单