hi_mpi_vpc_create_chn
Atlas 200/300/500 推理产品，不支持该接口。
Atlas 训练系列产品，不支持该接口。
函数功能
根据设置的通道属性创建图像处理通道，由用户指定通道号。
约束说明
- Atlas 推理系列产品上，单个Device上的通道号不能超出最大的通道号范围。用户在使用VPC功能或VDEC功能（内部会使用VPC功能）时，都会占用VPC通道号，为防止VPC功能与VDEC功能的通道号冲突，用户在使用VPC功能时，通道号的取值范围为[0,255]；在使用VDEC功能时，VDEC内部使用的VPC通道号范围为[256,511]。
- 如果参数attr为空，会返回错误码HI_ERR_VPC_NULL_PTR。
- 在创建图像处理通道之前必须保证通道未创建（或者已经销毁），否则会直接返回失败。
函数原型
hi_s32 hi_mpi_vpc_create_chn(hi_vpc_chn chn, const hi_vpc_chn_attr *attr)
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
chn |
输入 |
图片处理通道号。 Atlas 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas A2训练系列产品/Atlas 800I A2推理产品，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas 200/500 A2推理产品，该参数的取值范围：[0, 128)，通道总数最多128。
说明：
对于Atlas 推理系列产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数 = ( 被分配的VPC硬件单元 / VPC硬件单元总数 ) * 256，如果通道总数不为整数，则向下取整。 对于Atlas A2训练系列产品/Atlas 800I A2推理产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多256。 对于Atlas 200/500 A2推理产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多128。 昇腾虚拟化实例（Ascend Virtual Instance）的详细描述，以及各场景下的算力资源规格请参见《昇腾虚拟化实例（AVI）用户指南》。 |
attr |
输入 |
图片处理通道属性指针。 |
返回值说明
- 0：成功
- 非0：失败，参见VPC图像处理返回码
父主题： VPC图像处理功能
