aclrtPointerGetAttributes

Applicable Products

Product	Supported
Ascend 950PR/Ascend 950DT	√
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	√

Function

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

This is an encapsulated API that applies only to C++ programs. It internally calls the C API aclrtPointerGetAttributes.

Prototype

template <typename T>
aclError aclrtPointerGetAttributes(const T *ptr, aclrtPtrAttributes *attributes)

Parameters

Parameter	Input/Output	Description
ptr	Input	Memory address. The device address mapped by the aclrtHostRegister API or the device address obtained by the aclrtHostGetDevicePointer API cannot be passed. Otherwise, undefined behavior may occur.
attributes	Output	Memory attribute information. For details about the type definition, see aclrtPtrAttributes.

Parameter

Input/Output

Description

ptr

Input

Memory address.

The device address mapped by the aclrtHostRegister API or the device address obtained by the aclrtHostGetDevicePointer API cannot be passed. Otherwise, undefined behavior may occur.

attributes

Output

Memory attribute information. For details about the type definition, see aclrtPtrAttributes.

Returns

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

Parent topic: C++ Extension APIs