Atlas系列硬件: Atlas 200l DK A2 开发者套件; Atlas 200l DK 开发者套件（型号：3000）; 加速模块、加速卡、智能小站、服务器、集群

异构计算架构: CANN社区版; CANN商用版

AI框架: MindSpore; TensorFlow框架模型（社区版）; TensorFlow框架模型（商用版）; PyTorch框架适配

昇腾推理引擎: MindIE

应用使能MindX: MindX DL; MindX Edge; MindX SDK

全流程开发工具: MindStudio

hi_mpi_venc_create_chn

函数功能

创建编码通道。

约束说明

单个Device上的通道号不能超出最大的通道号范围。
编码通道属性由三部分组成，编码器属性、码率控制器属性和帧结构类型属性，帧结构类型属性简称GOP（Group of Pictures ）类型属性。
编码器属性必须设置编码码流buffer深度、获取码流方式、编码profile等，表1详细描述了各种协议的各项属性的特性。
推荐的编码宽高为：3840*2160(4k)、1920*1080(1080P)、1280*720(720P)。
H.264/H.265编码帧存由YHeaderSize、CHeaderSize、YSize、CSize、PmeSize、PmeInfoSize和TmvSize共同构成，编码器默认根据最大宽高计算帧存进行内存分配，在设置通道宽高时需保证根据通道宽高计算的每一部分帧存大小都不能大于最大宽高计算的帧存大小。

函数原型

hi_s32 hi_mpi_venc_create_chn(hi_venc_chn chn, const hi_venc_chn_attr *attr)

参数说明

参数名

输入/输出

说明

chn

输入

编码通道号。

编码通道号的取值范围：[0, 128)，JPEGE功能和VENC功能共用通道，且通道总数最多128。

attr

输入

编码通道属性的指针。

返回值说明

0：成功
非0：失败，参见VENC视频编码/JPEGE图片编码返回码

参考资源

接口调用流程及示例，参见JPEGE图片编码、VENC视频编码。

参考信息

表1 **编码器属性的约束**
编码协议	编码方式	码流 buffer 深度	获取码流模式	编码 profile
H.264	Frame	当 mini_buf_mode=0时，Buffer≥ max_pic_widthmax_pic_height3/4；当 mini_buf_mode=1时，Buffer≥32*1024 Byte；	Frame/Slice	Baseline Mainprofile Highprofile
JPEG	Frame	mini_buf_mode=0 时，如果原图格式为YUV420，Buffer最小值为原图宽16对齐原图高16对齐3/2 ；如果原图格式为YUV422 Packed，Buffer最小值为原图宽16对齐原图高16对齐2 mini_buf_mode=1 时，Buffer≥32*1024 Byte；	Frame/Ecs	Baseline
H.265	Frame	mini_buf_mode=0时，Buffer≥ max_pic_widthmax_pic_height3/4； mini_buf_mode=1时，Buffer≥32*1024 Byte	Frame/Slice	Main profile Main 10 profile（暂不支持）
H.265	Frame	mini_buf_mode=0时，Buffer≥ max_pic_widthmax_pic_height(3/4)(5/4）； mini_buf_mode=1时，Buffer≥321024 Byte	Frame/Slice	Main 10 profile（暂不支持）

父主题： VENC视频编码功能/JPEGE图片编码功能