Function: pointer_get_attributes

Applicable Products

Product

Supported (√/x)

Ascend 950PR/Ascend 950DT

√

Atlas A3 training products/Atlas A3 inference products

√

Atlas A2 training products/Atlas A2 inference products

√

Atlas training products

√

Atlas inference products

√

Atlas 200I/500 A2 inference products

√

Description

Obtains the memory attribute information, including whether the memory is on the host or device and the page table size.

Prototype

  • C Prototype
    1
    aclError aclrtPointerGetAttributes(const void *ptr, aclrtPtrAttributes *attributes)
    
  • Python Function
    1
    attributes, ret = acl.rt.pointer_get_attributes(ptr)
    

Parameters

Parameter

Description

ptr

Int, memory address.

Do not pass the device address mapped by acl.rt.host_register or the device address obtained by calling acl.rt.host_get_device_pointer. Otherwise, undefined behavior may occur.

Return Values

Return Value

Description

attributes

Dict, memory attributes. For details, see aclrtPtrAttributes.

ret

Int, error code. 0 on success; else, failure.