vpc_create_chn

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

根据设置的通道属性创建图像处理通道，由用户指定通道号。

Atlas 200/300/500 推理产品，当前版本该接口预留。

Atlas 训练系列产品，当前版本该接口预留。

C函数原型

        
             hi_s32 hi_mpi_vpc_create_chn(hi_vpc_chn chn, const hi_vpc_chn_attr *attr);

python函数

        
             ret = acl.himpi.vpc_create_chn(chn, attr)

参数名	说明
chn	int，图片处理通道号。 Atlas 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，通道总数最多256。 Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，通道总数最多128。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。说明：对于 Atlas 推理系列产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数 = ( 被分配的VPC硬件单元 / VPC硬件单元总数 ) * 256，如果通道总数不为整数，则向下取整。对于 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多256。对于 Atlas 200I/500 A2 推理产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多128。昇腾虚拟化实例（Ascend Virtual Instance）在各场景下的算力资源规格，在安装昇腾AI处理器的服务器上使用npu-smi info -t template-info命令查看。
attr	dict，图片处理通道属性字典，具体请参见hi_vpc_chn_attr。

参数名

说明

chn

int，图片处理通道号。

Atlas 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。
Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，该参数的取值范围：[0, 256)，通道总数最多256。
Atlas 200I/500 A2 推理产品，该参数的取值范围：[0, 128)，通道总数最多128。
Atlas A3 训练系列产品 / Atlas A3 推理系列产品，该参数的取值范围：[0, 256)，通道总数最多256。

说明：

对于 Atlas 推理系列产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数 = ( 被分配的VPC硬件单元 / VPC硬件单元总数 ) * 256，如果通道总数不为整数，则向下取整。

对于 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多256。

对于 Atlas 200I/500 A2 推理产品，昇腾虚拟化实例（Ascend Virtual Instance）场景下，通道总数最多128。

昇腾虚拟化实例（Ascend Virtual Instance）在各场景下的算力资源规格，在安装昇腾AI处理器的服务器上使用npu-smi info -t template-info命令查看。

attr

dict，图片处理通道属性字典，具体请参见hi_vpc_chn_attr。

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

Atlas 推理系列产品上，单个Device上的通道号不能超出最大的通道号范围。用户在使用VPC功能或VDEC功能（内部会使用VPC功能）时，都会占用VPC通道号，为防止VPC功能与VDEC功能的通道号冲突，用户在使用VPC功能时，通道号的取值范围为[0, 255]。在使用VDEC功能时，VDEC内部使用的VPC通道号范围为[256, 511]。
如果参数“attr”为空，会返回错误码“HI_ERR_VPC_NULL_PTR”。
在创建图像处理通道之前必须保证通道未创建（或者已经销毁），否则会直接返回失败。

父主题： VPC图像处理接口