Function: kernel_args_init_by_user_mem

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	√

Initializes the parameter list based on the kernel function handle and obtains the handle that identifies the parameter list.

Different from the acl.rt.kernel_args_init API, this API indicates that the memory is managed by the user.

C Prototype

aclError aclrtKernelArgsInitByUserMem(aclrtFuncHandle funcHandle, aclrtArgsHandle argsHandle, void *userHostMem, size_t actualArgsSize)

Python Function

ret = acl.rt.kernel_args_init_by_user_mem(func_handle, args_handle, user_host_mem, actual_args_size)

Parameter	Description
func_handle	Int, kernel function handle. Call acl.rt.binary_get_function to obtain the kernel function handle and transfer it to this API as an input parameter.
args_handle	Int, handle of the parameter list. You need to call the acl.rt.kernel_args_get_handle_mem_size API in advance to obtain the memory size, apply for the host memory, and then pass the host memory address as the input parameter.
user_host_mem	Int, host memory address. You need to call the acl.rt.kernel_args_get_mem_size API in advance to obtain the memory size, apply for the host memory, and then pass the host memory address as the input parameter.
actual_args_size	Int, memory size. Call acl.rt.kernel_args_get_mem_size to obtain the memory size and pass the memory size to this API as an input parameter.

Return Value	Description
ret	Int, 0 on success; else, failure.

Parent topic: Kernel Loading and Execution