aclrtBinaryGetFunction

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product / Atlas A3 inference product	√
Atlas A2 training product / Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

Description

Queries the kernel function based on the kernel function name and uses funcHandle to express the kernel function.

For the same binHandle, when the aclrtBinaryGetFunction API is called for the first time, the operator binary data associated with binHandle is copied to the device corresponding to the current context by default.

Prototype

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

Parameters

Parameter	Input/Output	Description
binHandle	Input	Handle of the operator binary. For details about the type definition, see aclrtBinHandle. Call aclrtBinaryLoadFromFile or aclrtBinaryLoadFromData to obtain the operator binary handle and pass it as an input parameter.
kernelName	Input	Kernel function name.
funcHandle	Output	Kernel function handle. For details about the type definition, see aclrtFuncHandle.

Parameter

Input/Output

Description

binHandle

Input

Handle of the operator binary. For details about the type definition, see aclrtBinHandle.

Call aclrtBinaryLoadFromFile or aclrtBinaryLoadFromData to obtain the operator binary handle and pass it as an input parameter.

kernelName

Input

Kernel function name.

funcHandle

Output

Kernel function handle. For details about the type definition, see aclrtFuncHandle.

Returns

0 on success; otherwise, failure. For details, see aclError.

API Call Example

For the API call example, see AI Core custom operator loading.

Parent topic: Kernel Loading and Execution