下载
中文
注册

pngd_create_chn

c函数原型

hi_s32 hi_mpi_pngd_create_chn(hi_pngd_chn chn, const hi_pngd_chn_attr *attr)

Python函数

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

函数功能

根据设置的通道属性创建解码通道。

Atlas 200/300/500 推理产品,当前版本不支持该接口。

Atlas 训练系列产品,当前版本不支持该接口。

输入说明

chn: int,解码通道号。

该参数的取值范围为[0, 128),通道总数最多128。

说明:

对于Atlas 推理系列产品昇腾虚拟化实例(Ascend Virtual Instance)场景下,使用不同的昇腾虚拟化实例(Ascend Virtual Instance)模板,对通道数的限制不同:

  • 使用vir04_4c_dvpp模板时,通道总数固定为128。
  • 使用vir04_3c_ndvpp模板时,表示不使用DVPP功能,因此通道总数为0。
  • 使用其它模板时,通道总数 =切分规格 * 128,如果通道总数不为整数,则向下取整。

对于Atlas A2训练系列产品/Atlas 800I A2推理产品昇腾虚拟化实例(Ascend Virtual Instance)场景下,使用不同的昇腾虚拟化实例(Ascend Virtual Instance)模板,对通道数的限制不同:

  • 使用vir12_3c_32g_m、vir10_3c_16g_m、vir10_3c_32g_m模板时,通道总数固定为128。
  • 使用vir12_3c_32g_nm、vir10_3c_16g_nm、vir10_3c_32g_nm模板时,表示不使用DVPP功能,因此通道总数为0。
  • 使用其它模板时,通道总数 =切分规格 * 128,如果通道总数不为整数,则向下取整。

昇腾虚拟化实例(Ascend Virtual Instance)的详细描述,以及各场景下的算力资源规格请参见《昇腾虚拟化实例(AVI)用户指南》

attr:dict,解码通道属性字典,具体请参见hi_pngd_chn_attr

返回值说明

ret:int,错误码。

约束说明

  • 单个Device上的通道号不能超出最大的通道号范围。
  • 如果参数“attr”为空,会返回错误码“HI_ERR_PNGD_NULL_PTR”
  • 在创建PNG解码通道之前必须保证通道未创建(或者已经销毁),否则会直接返回错误。
  • 系统内存不足时会返回“HI_ERR_PNGD_NO_MEM”的错误码,可考虑扩展操作系统内存。
  • 当通道属性“attr”中的值超过解码能力集时,会返回“HI_ERR_PNGD_ILLEGAL_PARAM”的错误码。

参考场景

接口调用流程,参见功能及约束说明