跳到主要内容

aclrtGetSocName

aclSetCompileopt​

函数功能​

用户可调用本接口设置对应的编译选项，该选项为进程级全局共享，算子或模型开始编译时，以当前的编译选项为准，一次编译过程中不会变更。同步接口。

使用场景：用户可以在调用aclopCompile接口编译算子或aclopCompileAndExecute接口编译执行算子前，调用本接口设置编译选项。

函数原型​

aclError aclSetCompileopt(****aclCompileOpt opt, const char *value)

参数说明​

参数名输入/输出说明
opt输入编译选项。
value输入编译选项具体值的指针。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 系统配置

aclGetCompileopt​

函数功能​

用户可调用本接口获取编译选项的值。同步接口。

使用场景：用户可以调用本接口获取当前编译选项的值，在调用aclSetCompileopt前，本接口返回的是各编译选项的默认值；在调用aclSetCompileopt后，本接口返回的是用户设置的值。

函数原型​

aclError aclGetCompileopt(****aclCompileOpt opt, char *value, size_t length)

参数说明​

参数名输入/输出说明
opt输入编译选项。
value输出存放编译选项值的内存的指针。 用户在调用本前需要申请一块内存来保存编译选项的值，内存大小可以通过aclGetCompileoptSize获得。
length输入value指向内存的大小，单位：Byte。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 系统配置

aclGetCompileoptSize​

函数功能​

用户可调用本接口获取存放编译选项值的内存大小。同步接口。

使用场景：用户在调用aclGetCompileopt前需要申请一块内存来保存编译选项的值，内存大小可以通过调用本接口获得。

函数原型​

size_t aclGetCompileoptSize(aclCompileOpt opt)

参数说明​

参数名输入/输出说明
opt输入编译选项。

返回值说明​

返回存放该编译选项值的内存大小，单位：Byte。

父主题： 系统配置

aclrtGetSocName​

函数功能​

查询当前运行环境的芯片版本。同步接口。

函数原型​

const char *aclrtGetSocName()

参数说明​

无

返回值说明​

返回芯片版本字符串的指针。如果通过该接口获取芯片版本失败，则返回空指针。

父主题： 系统配置

aclGetRecentErrMsg​

函数功能​

获取并清空与本接口在同一个线程中的其它AscendCL接口调用失败时的错误描述信息。同步接口。

约束说明​

建议在每次调用AscendCL接口失败时都调用aclGetRecentErrMsg接口，以便获取调用AscendCL接口异常时的错误描述信息，用于定位问题。同一个线程中多次调用aclGetRecentErrMsg接口后，只有最后一次调用aclGetRecentErrMsg接口返回的错误描述字符串的指针有效，之前aclGetRecentErrMsg接口返回的错误描述字符串指针不能使用，否则可能导致内存非法访问。

如果未在每次调用AscendCL接口失败时调用aclGetRecentErrMsg接口，则可能导致错误信息堆积、丢失。

函数原型​

const char *aclGetRecentErrMsg()

参数说明​

无

返回值说明​

返回错误描述字符串的指针。如果通过本接口获取到多条错误描述信息，最上面的错误描述信息为最新的。

获取错误描述信息失败时，返回nullptr。

父主题： 系统配置

aclrtSetDeviceSatMode​

函数功能​

设置当前Context对应的Device的浮点计算结果输出模式，同步接口。

Atlas 200/500 A2推理产品，不支持该接口。

约束说明​

调用该接口成功后，后续在该Device上新创建的Stream按设置的模式生效，对之前已创建的Stream不生效。

函数原型​

aclError aclrtSetDeviceSatMode(aclrtFloatOverflowMode mode)

参数说明​

参数名输入/输出说明
mode输入设置浮点计算结果输出模式。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 系统配置

aclrtGetDeviceSatMode​

函数功能​

查询当前Context对应的Device的浮点计算结果输出模式，同步接口。

Atlas 200/500 A2推理产品，不支持该接口。

函数原型​

aclError aclrtGetDeviceSatMode(aclrtFloatOverflowMode *mode)

参数说明​

参数名输入/输出说明
mode输出获取浮点计算结果输出模式。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 系统配置

在线提单