函数：vdec_destroy_frame_config

函数：vdec_send_frame

C函数原型	aclError aclvdecSendFrame(aclvdecChannelDesc *channelDesc, acldvppStreamDesc *input, acldvppPicDesc *output, aclvdecFrameConfig *config, void* userData)
Python函数	ret = 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，输入码流描述信息的指针地址，输入内存用户需提前申请。 - 调用acl.media.dvpp_create_stream_desc接口创建码流描述信息。调用acl.media.dvpp_set_stream_desc系列接口设置视频码流信息的属性（例如，码流格式）。输入码流格式以通道描述信息中设置的格式为准，调用acl.media.dvpp_set_stream_desc_format接口设置输入码流格式无效。 - 输入视频码流的分辨率、视频格式的要求，请参见功能及约束说明。 dvpp_pic_desc：int，输出图片描述信息的指针地址，输出内存用户需提前申请。 dvpp_pic_desc参数作为输入时，需要用户调用如下接口： - 调用acl.media.dvpp_create_pic_desc接口创建图片描述信息。 - 调用acl.media.dvpp_set_pic_desc系列接口设置输出图片的数据内存、内存大小、宽、高、格式。 - 如果此处设置输出图片的宽高，则需要同时设置width、height、width_stride、height_stride这4个参数，且当width<16时，width_stride必须对齐到32，不能对齐到16；如果这4个参数都不设置，则以输入码流的宽高为准；如果设置部分参数，则接口返回错误。 - 如果此处设置输出图片的格式，则以此处为准；如果此处不设置，则以通道描述信息中设置的为准。 - 输出图像格式的要求，请参见功能及约束说明。 dvpp_pic_desc参数作为输出时，用户需在回调函数中调用acl.media.dvpp_get_pic_desc系列接口获取解码后的输出图片数据。隔行码流场景下，隔行码流每帧发送两场，解码时其中一场无图像输出，属于正常现象，会返回ERR_DECODE_NOPIC = 0x20000错误码；隔行码流的解码输出数据都在奇数场对应的输出buffer中。 vdec_frame_config：int，解码配置的指针地址，预留，当前可填0。 user_data：python对象，用户自定义数据的指针地址。 如果用户需要获取解码的帧序号，则可以在user_data参数处定义，然后解码的帧序号可以通过user_data参数传递给VDEC的回调函数，用于确定回调函数中处理的是第几帧数据。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。
约束说明	- 发送数据前必须保证通道已经被创建，否则返回错误。 - 发送码流时须按帧发送，一次只发送完整的一帧码流。 - 不能发送eos为0的空码流包（码流长度为0或码流地址为空）。 - 发送完所有码流后，可以发送eos为1的空码流包，表示当前码流文件结束。发送eos后，本接口会等待已发送帧全部解码并且用户的回调函数处理完成后才返回。 - 由于码流异常、解码超时等原因，可能导致acl.media.vdec_send_frame接口发送帧或发送eos失败，建议用户在编写代码时，获取该接口的返回码，当该接口调用失败时，进行异常处理。 - acl.media.vdec_send_frame接口内部封装了acl.rt.launch_callback接口，用于在Stream的任务队列中增加一个需要执行的回调函数。用户在实现VDEC功能时，无需再单独调用acl.rt.launch_callback接口。
参考资源	接口调用流程及示例，参见VDEC视频解码。

父主题： VDEC功能

函数：vdec_send_skipped_frame

C函数原型	aclError aclvdecSendSkippedFrame(aclvdecChannelDesc *channelDesc, acldvppStreamDesc *input, aclvdecFrameConfig *config, void *userData)
Python函数	ret = acl.media.vdec_send_skipped_frame(vdec_channel_desc, dvpp_stream_desc, vdec_frame_config, user_data)
函数功能	如果不想获取某一帧的解码结果， 可以调用本接口， 将待解码的码流（输入内存)传到解码器进行解码，此时，解码结果最终不会输出，解码完成的回调函数中返回的dvpp_pic_desc为0。异步接口。
输入说明	vdec_channel_desc：int，指定通道描述信息的指针地址。 与调用acl.media.dvpp_create_channel接口创建通道时指定的dvpp_channel_desc保持一致。 调用acl.media.vdec_set_channel_desc系列接口设置通道描述信息的属性，包括解码通道号、线程、回调函数、视频编码协议等。 dvpp_stream_desc：int，输入码流描述信息的指针地址，输入内存用户需提前申请。 - 调用acl.media.dvpp_create_stream_desc接口创建码流描述信息，调用acl.media.dvpp_set_stream_desc系列接口设置视频码流信息的属性（例如，码流格式）。 输入码流格式以通道描述信息中设置的格式为准，调用acl.media.dvpp_set_stream_desc_format接口设置输入码流格式无效。 - 输入视频码流的分辨率、视频格式的要求，请参见功能及约束说明。 vdec_frame_config：int，解码配置的指针地址，预留，当前可填0。 user_data：python对象，用户自定义数据的指针地址。 如果用户需要获取解码的帧序号，则可以在“user_data”参数处定义，然后解码的帧序号可以通过“user_data”参数传递给VDEC的回调函数，用于确定回调函数中处理的是第几帧数据。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。
约束说明	- 发送数据前必须保证通道已经被创建，否则返回错误。 - 发送码流时须按帧发送，一次只发送完整的一帧码流。 - 不能发送eos为0的空码流包（码流长度为0或码流地址为空）。 - 不可以发送eos为1的帧。 - 由于码流异常、解码超时等原因，可能导致acl.media.vdec_send_frame接口发送帧或发送eos失败，建议用户在编写代码时，获取该接口的返回码，当该接口调用失败时，进行异常处理。 - acl.media.vdec_send_skipped_frame接口内部封装了acl.rt.launch_callback接口，用于在Stream的任务队列中增加一个需要在Host上执行的回调函数。用户在实现VDEC功能时，无需再单独调用acl.rt.launch_callback接口。

父主题： VDEC功能

函数：vdec_create_frame_config

C函数原型	aclvdecFrameConfig *aclvdecCreateFrameConfig()
Python函数	vdec_frame_config = acl.media.vdec_create_frame_config()
函数功能	创建aclvdecFrameConfig类型的数据，表示创建VDEC解码时的单帧解码配置参数。同步接口。 如需销毁aclvdecFrameConfig类型的数据，请参见acl.media.vdec_destroy_frame_config。
返回值说明	vdec_frame_config：int，vdec_frame_config的指针地址。 - 返回非0值，表示成功。 - 返回0，表示失败。

父主题： VDEC功能

函数：vdec_destroy_frame_config

C函数原型	aclError aclvdecDestroyFrameConfig(aclvdecFrameConfig *vdecFrameConfig)
Python函数	ret = acl.media.vdec_destroy_frame_config(vdec_frame_config)
函数功能	销毁通过acl.media.vdec_create_frame_config接口创建的配置数据。同步接口。
输入说明	vdec_frame_config：int，指定待销毁的数据。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。

父主题： VDEC功能

函数：vdec_create_channel_desc

C函数原型	aclvdecChannelDesc *aclvdecCreateChannelDesc()
Python函数	vdec_channel_desc = acl.media.vdec_create_channel_desc()
函数功能	创建vdec_channel_desc类型的数据，表示创建视频数据解码处理通道时的通道描述信息。该接口为同步接口。 如需销毁aclvdecChannelDesc类型的数据，请参见acl.media.vdec_destroy_channel_desc。
返回值说明	vdec_channel_desc：int，vdec通道描述地址对象。 - 返回vdec_channel_desc类型数据，表示成功。 - 返回0，表示失败。

父主题： VDEC功能

函数：vdec_destroy_channel_desc

C函数原型	aclError aclvdecDestroyChannelDesc(aclvdecChannelDesc *channelDesc)
Python函数	ret = acl.media.vdec_destroy_channel_desc(vdec_channel_desc)
函数功能	销毁通过acl.media.vdec_create_channel_desc接口创建的aclvdecChannelDesc类型的数据。同步接口。
输入说明	vdec_channel_desc：int，待销毁的aclvdecChannelDesc类型的指针地址。
返回值说明	ret：int ，错误码。 - 返回0表示成功。 - 返回其它值表示失败。

父主题： VDEC功能

函数：vdec_set_channel_desc_channel_id

C函数原型	aclError aclvdecSetChannelDescChannelId(aclvdecChannelDesc *channelDesc, uint32_t channelId)
Python函数	ret = acl.media.vdec_set_channel_desc_channel_id(vdec_channel_desc, channel_id)
函数功能	设置视频解码处理通道描述信息的属性：解码通道号。
输入说明	vdec_channel_desc：int，视频解码处理通道描述信息的指针地址。 channel_id：int，通道ID。 Atlas 200/500 A2推理产品，该参数值的取值范围[0, 255]。
返回值说明	ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。

父主题： VDEC功能

在线提单