函数：vdec_create_channel

Atlas A3 训练系列产品/Atlas A3 推理系列产品

√

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

√

Atlas 训练系列产品

√

Atlas 推理系列产品

√

Atlas 200I/500 A2 推理产品

√

Atlas 200/300/500 推理产品

√

aclError aclvdecCreateChannel(aclvdecChannelDesc *channelDesc)

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上回调函数的线程数量等。

接口调用流程及示例，参见媒体数据处理V1。