aclrtHostMemMapCapabilities

Applicability

Product	Supported
Atlas 350 Accelerator Card	☓
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

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. Must be in the range of [0, 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.

Must be in the range of [0, 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; else, failure. For details, see aclError.

Parent topic: Memory Management