aclrtBinaryLoadFromData

Applicability

Product

Supported

Atlas A3 training products/Atlas A3 inference products

Atlas A2 training products/Atlas A2 inference products

Atlas 200I/500 A2 inference products

Atlas inference products

Atlas training products

Description

Loads and parses the operator binary data from the memory, copies the data to the device corresponding to the current context by default, and outputs the binHandle that points to the data.

When calling this API to load an AI CPU operator (aclrtBinaryLoadOption.type contains ACL_RT_BINARY_LOAD_OPT_CPU_KERNEL_MODE), call aclrtRegisterCpuFunc to register the operator.

The system only loads the operator to the device corresponding to the current context. Therefore, when aclrtLaunchKernelWithConfig is called to start the compute task for the operator, the device on which the task is performed must be the same as the device to which the operator is loaded.

Prototype

aclError aclrtBinaryLoadFromData(const void *data, size_t length, const aclrtBinaryLoadOptions *options, aclrtBinHandle *binHandle)

Parameters

Parameter

Input/Output

Description

data

Input

Address of the host memory for storing the operator binary data. The value cannot be null.

length

Input

Memory size of the operator binary data, in bytes. The value must be greater than 0.

options

Input

Optional parameter for loading the operator binary file.

binHandle

Output

Handle of the operator binary file.

Returns

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