---
title: aclrtBinaryLoadFromFile
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_1792.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_1792.html
indexId: 30c88820eeecdf491b80c09587f27dbdc25a9f198605a641b6ce951564a6fa4568
---
# aclrtBinaryLoadFromFile

#### 产品支持情况

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


#### 功能说明

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

对于AI Core算子，若使用本接口加载并解析算子二进制文件，需配套使用aclrtLaunchKernelWithConfig、aclrtLaunchKernelV2或aclrtLaunchKernelWithHostArgs接口下发计算任务。


#### 函数原型

```
aclError aclrtBinaryLoadFromFile(const char* binPath, aclrtBinaryLoadOptions *options, aclrtBinHandle *binHandle)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| binPath | 输入 | 算子二进制文件（\*.o文件）的路径，要求绝对路径。 对于AI CPU算子，该参数支持传算子信息库文件（\*.json）。 |
| options | 输入 | 加载算子二进制文件的可选参数。类型定义请参见aclrtBinaryLoadOptions。 |
| binHandle | 输出 | 标识算子二进制的句柄。类型定义请参见aclrtBinHandle。 |


#### 返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。


#### 约束说明

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


#### 接口调用示例

接口调用示例，参见AI Core自定义算子加载(https://www.hiascend.comdocument/detail/zh/canncommercial/900/programug/acldevg/runtime_doc_dev_0019.html)。