aclrtMemGetAccess

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

Obtains the memory access permission.

Prototype

aclError aclrtMemGetAccess(void *virPtr, aclrtMemLocation *location, uint64_t *flag)

Parameters

Parameter	Input/Output	Description
virPtr	Input	Start address of the virtual memory. The value must be the same as the aclrtMapMem API's virPtr address.
location	Input	Memory location. For details about the type definition, see aclrtMemLocation. Currently, aclrtMemLocation.type can only be set to ACL_MEM_LOCATION_TYPE_HOST or ACL_MEM_LOCATION_TYPE_DEVICE. If aclrtMemLocation.type is set to ACL_MEM_LOCATION_TYPE_HOST, aclrtMemLocation.id is invalid and can be fixed at 0.
flag	Output	Memory access protection flag.

Parameter

Input/Output

Description

virPtr

Input

Start address of the virtual memory.

The value must be the same as the aclrtMapMem API's virPtr address.

location

Input

Memory location. For details about the type definition, see aclrtMemLocation.

Currently, aclrtMemLocation.type can only be set to ACL_MEM_LOCATION_TYPE_HOST or ACL_MEM_LOCATION_TYPE_DEVICE. If aclrtMemLocation.type is set to ACL_MEM_LOCATION_TYPE_HOST, aclrtMemLocation.id is invalid and can be fixed at 0.

flag

Output

Memory access protection flag.

Returns

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

Parent topic: Memory Management