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

#### 产品支持情况

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


#### 功能说明

根据kernel_name，查找到对应的kernel对象，使用func_handle表达。

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


#### 函数原型

- C函数原型
  1 aclError aclrtBinaryGetFunction(const aclrtBinHandle binHandle, const char *kernelName, aclrtFuncHandle *funcHandle)

- python函数
  1 func_handle, ret= acl.rt.binary_get_function(bin_handle, kernel_name)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| bin\_handle | int，指向算子二进制的handle。调用acl.rt.binary\_load接口获取binHandle。 |
| kernel\_name | str，kernel名称。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| func\_handle | int，标识指定kernel的func\_handle表达的指针地址。 |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |