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

#### 产品支持情况

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


#### 功能说明

根据核函数名称，查找到对应的核函数，并使用funcHandle表达。

对于同一个binHandle，首次调用aclrtBinaryGetFunction接口时，会默认将binHandle关联的算子二进制数据拷贝至当前Context对应的Device上。


#### 函数原型

```
aclError aclrtBinaryGetFunction(const aclrtBinHandle binHandle, const char *kernelName, aclrtFuncHandle *funcHandle)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| binHandle | 输入 | 算子二进制句柄。类型定义请参见aclrtBinHandle。 调用aclrtBinaryLoadFromFile接口或aclrtBinaryLoadFromData接口获取算子二进制句柄，再将其作为入参传入本接口。 |
| kernelName | 输入 | 核函数名称。 |
| funcHandle | 输出 | 核函数句柄。类型定义请参见aclrtFuncHandle。 |


#### 返回值说明

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


#### 接口调用示例

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