aclrtHostGetDevicePointer

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 device memory address registered and mapped by the aclrtHostRegister or aclrtHostRegisterV2 API. This address cannot be used for memory operations, such as memory copy.

Prototype

aclError aclrtHostGetDevicePointer(void *pHost, void **pDevice, uint32_t flag)

Parameters

Parameter	Input/Output	Description
pHost	Input	Host memory address registered and mapped by the aclrtHostRegister or aclrtHostRegisterV2 API.
pDevice	Output	Device memory address mapped from the host memory.
flag	Input	Reserved. The value is fixed at 0.

Returns

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

Parent topic: Host Memory Management