昇腾社区首页
中文
注册

MxInit

函数功能

全局初始化,申请Device资源与日志资源,Vision SDK接口全部执行完毕后,用户需调用MxDeInit()接口对初始化的全局资源进行去初始化操作。

  • 对于Atlas 200/300/500 推理产品Atlas 200I/500 A2 推理产品:使用MxInit()。
  • 对于Atlas 推理系列产品:可以使用MxInit的全部函数原型。调用MxInit()后,在初次调用ImageProcessor类图像处理接口和TensorOperations的部分接口会初始化DVPP资源池,再次调用接口时不会进行初始化,会直接使用DVPP通道资源池,其中DVPP资源池大小可通过“globalCfg”“globalCfgExtra”进行设置。第一次调用ImageProcessor和TensorOperations的部分接口时间会包含DVPP资源池初始化的时间,导致接口调用的总体时间增长。
  • 对于Atlas 800I A2 推理服务器:可以使用MxInit的全部函数原型。调用MxInit()后,可直接使用DVPP通道资源池,其中DVPP通道资源池大小可通过“globalCfg”“globalCfgExtra”进行设置。
  • 一个进程内只能调用一次MxInit接口。
  • DVPP资源池所申请的底层通道资源为进程共享,多进程场景可能导致资源耗尽,请谨慎使用。
  • DVPP资源池与VideoEncoder及VideoDecoder共享底层通道资源,极端场景可能导致资源耗尽,建议根据实际场景的需要进行资源池大小的初始化。
  • 该接口会注册监测日志数量和监测日志时间的线程,线程命名分别为“log_filenum”“log_time”

函数原型

APP_ERROR MxInit();
APP_ERROR MxInit(const AppGlobalCfg &globalCfg);
APP_ERROR MxInit(const AppGlobalCfgExtra &globalCfgExtra); 

参数说明

参数名

输入/输出

说明

globalCfg

输入

AppGlobalCfg类型,应用全局配置。

globalCfgExtra

输入

AppGlobalCfgExtra类型,应用全局配置。

返回参数说明

数据结构

说明

APP_ERROR

程序执行返回的错误码,请参考APP_ERROR说明