函数：dvpp_create_channel

产品支持情况

产品	是否支持
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

功能说明

创建图片数据处理的通道，同一个通道可以重复使用，销毁后不再可用。

函数原型

C函数原型

        
             aclError acldvppCreateChannel(acldvppChannelDesc *channelDesc)

python函数

        
             ret = acl.media.dvpp_create_channel(dvpp_channel_desc)

参数说明

参数名	说明
dvpp_channel_desc	int，指定通道描述信息的指针地址。调用acl.media.dvpp_create_channel_desc接口创建该输入数据。同时，对于 Atlas 推理系列产品，您还需要调用dvpp_set_channel_desc_mode接口指定通道描述信息中的通道模式，明确图片数据处理通道用于实现哪种功能，目前支持VPC、JPEGD、JPEGE、PNGD功能。若不指定通道模式，则系统默认4种模式的通道都创建，可能会占用通道资源（通道数的限制，请参见总体说明）。

参数名

说明

dvpp_channel_desc

int，指定通道描述信息的指针地址。调用acl.media.dvpp_create_channel_desc接口创建该输入数据。

同时，对于 Atlas 推理系列产品，您还需要调用dvpp_set_channel_desc_mode接口指定通道描述信息中的通道模式，明确图片数据处理通道用于实现哪种功能，目前支持VPC、JPEGD、JPEGE、PNGD功能。若不指定通道模式，则系统默认4种模式的通道都创建，可能会占用通道资源（通道数的限制，请参见总体说明）。

返回值说明

返回值	说明
ret	int，错误码，返回0表示成功，返回其它值表示失败。

约束说明

通道为非线程安全，即不同线程要求创建不同的通道。
同一个通道不能同时在多个Stream中并发使用。
acl.media.dvpp_create_channel接口内部调用1次acl.rt.create_stream接口创建了1个Stream，该Stream用于创建通道的任务，创建通道的任务结束后，该Stream资源自动释放。
用户在创建通道时，acl.rt.create_stream接口的约束需要遵循，例如Stream的数量等。

资源参考

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

父主题： VPC/JPEGD/JPEGE/PNGD图片处理通道