Function: binary_get_function

Applicability

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

Description

Searches for the kernel object based on kernel_name and uses func_handle to express the kernel object.

For the same bin_handle, when acl.rt.binary_get_function is called for the first time, the binary data of the operator associated with the bin_handle is copied to the device corresponding to the current context by default.

Prototype

C Prototype

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

Python Function

func_handle, ret= acl.rt.binary_get_function(bin_handle, kernel_name)

Parameters

Parameter	Description
bin_handle	Int, handle pointing to the operator binary. Call acl.rt.binary_load to obtain binHandle.
kernel_name	Str, kernel name.

Return Value

Return Value	Description
func_handle	Int, pointer address of the func_handle expression of the specified kernel.
ret	Int, error code. 0 on success; else, failure.

Parent topic: Kernel Loading and Execution