---
title: 函数：binary_load_from_file
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_1080.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_1080.html
indexId: 7988faa76f3e286f5b49640706c0298eeba8ce9dc9f67a3dc284e28e97a7830671
---
# 函数：binary_load_from_file

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

从文件加载并解析算子二进制文件，输出指向算子二进制的binHandle。

对于AI Core算子，若使用本接口加载并解析算子二进制文件，需配套使用acl.rt.launch_kernel_with_config接口下发计算任务。


#### 函数原型

- C函数原型
  1 aclError aclrtBinaryLoadFromFile(const char* binPath, aclrtBinaryLoadOptions *options, aclrtBinHandle *binHandle)

- python函数
  1 bin_handle, ret = acl.rt.binary_load_from_file(bin_path, options)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| bin\_path | str，算子二进制文件（.o文件）的路径，要求绝对路径。对于AI CPU算子，该参数支持传算子信息库文件（.json）。 |
| options | list，加载算子二进制文件的可选参数，结构参考aclrtBinaryLoadOptions，若参数为空，可将options设置为[]。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| bin\_handle | int，标识算子二进制的句柄。 |
| ret | int，返回0表示成功，返回其他值表示失败。 |


#### 约束说明

针对某一型号的产品，编译生成的算子二进制文件，必须在相同型号的产品上使用。