函数:vdec_create_channel
产品支持情况
产品 |
是否支持 |
---|---|
|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
功能说明
创建视频数据处理的通道,同一个通道可以重复使用,销毁后不再可用。
函数原型
- C函数原型
1
aclError aclvdecCreateChannel(aclvdecChannelDesc *channelDesc)
- python函数
1
ret = acl.media.vdec_create_channel(vdec_channel_desc)
参数说明
参数名 |
说明 |
---|---|
vdec_channel_desc |
int,通道描述信息的指针地址。 调用acl.media.vdec_create_channel_desc接口创建vdec_channel_desc类型的数据,调用acl.media.vdec_set_channel_desc系列接口设置通道描述信息的属性。 |
返回值说明
返回值 |
说明 |
---|---|
ret |
int,错误码,返回0表示成功,返回其它值表示失败。 |
约束说明
- 通道为非线程安全,即不同线程要求创建不同的通道。
- 通道数的限制,请参见总体说明。
- acl.media.vdec_create_channel接口内部封装了acl.rt.create_stream接口和acl.rt.subscribe_report:
- 调用2次acl.rt.create_stream接口创建了2个Stream,一个Stream用于视频码流解码任务,另一个用于回调函数的处理。这些Stream资源只有在调用acl.media.vdec_destroy_channel接口销毁通道后才能自动释放。
- 调用acl.rt.subscribe_report接口指定处理Stream上回调函数的线程,回调函数和线程是由用户调用acl.media.vdec_set_channel_desc系列接口时指定的。
用户在实现VDEC功能时,无需再单独调用acl.rt.create_stream接口、acl.rt.subscribe_report接口,但acl.rt.create_stream接口、acl.rt.subscribe_report接口的约束需要遵循,例如Stream的数量、处理Stream上回调函数的线程数量等。
父主题: VDEC视频解码通道