函数：vdec_send_frame
产品支持情况
|
产品 |
是否支持 |
|---|---|
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
功能说明
将待解码的输入内存和解码输出内存一起传到解码器进行解码，异步接口。
函数原型
- C函数原型
1aclError aclvdecSendFrame(aclvdecChannelDesc *channelDesc, acldvppStreamDesc *input, acldvppPicDesc *output, aclvdecFrameConfig *config, void* userData)
- python函数
1ret = acl.media.vdec_send_frame(vdec_channel_desc, dvpp_stream_desc, dvpp_pic_desc, vdec_frame_config, user_data)
参数说明
|
参数名 |
说明 |
|---|---|
|
vdec_channel_desc |
int，指定通道描述信息的指针地址。 与调用acl.media.dvpp_create_channel接口创建通道时指定的“dvpp_channel_desc”保持一致。 调用acl.media.vdec_set_channel_desc系列接口设置通道描述信息的属性，包括解码通道号、线程、回调函数、视频编码协议等。
说明：
对于 对于 |
|
dvpp_stream_desc |
int，输入码流描述信息的指针地址，输入内存用户需提前申请。
|
|
dvpp_pic_desc |
int，输出图片描述信息的指针地址，输出内存用户需提前申请。 “dvpp_pic_desc”参数作为输入时，需要用户调用如下接口：
|
|
vdec_frame_config |
int，解码配置的指针地址，预留，当前可填0。 |
|
user_data |
python对象，用户自定义数据的指针地址。 如果用户需要获取解码的帧序号，则可以在“user_data”参数处定义，然后解码的帧序号可以通过“user_data”参数传递给VDEC的回调函数，用于确定回调函数中处理的是第几帧数据。 |
返回值说明
|
返回值 |
说明 |
|---|---|
|
ret |
int，错误码，返回0表示成功，返回其它值表示失败。 |
约束说明
- 本接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，acl.rt.synchronize_stream）确保任务已执行完成。
-
发送完所有码流后，可以发送eos为1的空码流包，表示当前码流文件结束。发送eos后，本接口会等待已发送帧全部解码并且用户的回调函数处理完成后才返回。
- 由于码流异常、解码超时等原因，可能导致acl.media.vdec_send_frame接口发送帧或发送eos失败，建议用户在编写代码时，获取该接口的返回码，当该接口调用失败时，进行异常处理。
- acl.media.vdec_send_frame接口内部封装了acl.rt.launch_callback接口，用于在Stream的任务队列中增加一个需要执行的回调函数。用户在实现VDEC功能时，无需再单独调用acl.rt.launch_callback接口。