aclrtMemExportToShareableHandleV2

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

√

handle

Input

Handle for storing physical memory information. For details about the type definition, see aclrtDrvMemHandle.

You need to call aclrtMallocPhysical in this process to allocate physical memory. If this API is successfully called, a handle is returned.

There is a one-to-one mapping between handles and shareableHandles. In the same process, one-to-many or many-to-one mapping is not allowed. Otherwise, an error is reported. For example, if this API is repeatedly called to export data, an error is reported.

flags

Input

Whether to enable process trustlist verification.

The value can be either of the following macros:

• ACL_RT_VMM_EXPORT_FLAG_DEFAULT: Default value. It means enabling the process trustlist verification.

  If you set the parameter to this value, call the aclrtMemSetPidToShareableHandleV2 API separately to add the ID of the process that uses shareableHandle to the trustlist.

• ACL_RT_VMM_EXPORT_FLAG_DISABLE_PID_VALIDATION: Disables the process trustlist verification.

  If you set the parameter to this value, you do not need to call the aclrtMemSetPidToShareableHandleV2 API.

The macros are defined as follows:

#define ACL_RT_VMM_EXPORT_FLAG_DEFAULT                0x0UL
#define ACL_RT_VMM_EXPORT_FLAG_DISABLE_PID_VALIDATION 0x1UL

shareType

Input

Type of the exported shared handle. For details about the type definition, see aclrtMemSharedHandleType.

shareableHandle

Output

Pointer to the shared handle. The memory to which the pointer points is provided by the caller. The size is determined by shareType.

If shareType is ACL_MEM_SHARE_HANDLE_TYPE_DEFAULT, the pointer points to an uint64_t variable.

If shareType is ACL_MEM_SHARE_HANDLE_TYPE_FABRIC, the pointer points to an aclrtMemFabricHandle structure.

typedef struct aclrtMemFabricHandle { 
    uint8_t data[128];
} aclrtMemFabricHandle;