aclrtHostMemMapCapabilities

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

Queries whether a specified hardware driver accelerator supports access to the memory registered through the aclrtHostRegister API.

Prototype

aclError aclrtHostMemMapCapabilities(uint32_t deviceId, aclrtHacType hacType, aclrtHostMemMapCapability *capabilities)

Parameters

Parameter	Input/Output	Description
deviceId	Input	Device ID. The value must be in the range of [0, (Available device count – 1)]. Call aclrtGetDeviceCount to obtain the device count.
hacType	Input	Type of the hardware accelerator controller (HAC). For details about the type definition, see aclrtHacType.
capabilities	Output	Whether access to the memory registered through the aclrtHostRegister API is supported. For details about the type definition, see aclrtHostMemMapCapability.

Parameter

Input/Output

Description

deviceId

Input

Device ID.

The value must be in the range of [0, (Available device count – 1)]. Call aclrtGetDeviceCount to obtain the device count.

hacType

Input

Type of the hardware accelerator controller (HAC). For details about the type definition, see aclrtHacType.

capabilities

Output

Whether access to the memory registered through the aclrtHostRegister API is supported. For details about the type definition, see aclrtHostMemMapCapability.

Returns

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

Parent topic: Host Memory Management