aclrtMemGetAccess

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

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. 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.

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