aclrtMallocHostWithCfg

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

Allocates host memory (page-locked memory). The system ensures that the start address of the memory is 64-byte aligned.

Compared with aclrtMallocHost, this API can also specify memory configuration when allocating memory.

The memory allocated by this API can only be freed by calling aclrtFreeHost or aclrtFreeHostWithDevSync.

For the Ascend RC form and Open Ctrl CPU form, the host and device are integrated. Therefore, allocating host memory is equivalent to allocating device memory. In addition, memory is allocated based on normal pages. If the start address needs to be 64-byte aligned, you need to handle the alignment problem by yourself.

Prototype

aclError aclrtMallocHostWithCfg(void **ptr, uint64_t size, aclrtMallocConfig *cfg)

Parameters

Parameter	Input/Output	Description
ptr	Output	Pointer to the pointer to the allocated memory.
size	Input	Memory size in bytes to allocate. size cannot be 0.
cfg	Input	Memory configuration. For details about the type definition, see aclrtMallocConfig. If no configuration is specified, NULL can be passed.

Parameter

Input/Output

Description

ptr

Output

Pointer to the pointer to the allocated memory.

size

Input

Memory size in bytes to allocate.

size cannot be 0.

cfg

Input

Memory configuration. For details about the type definition, see aclrtMallocConfig.

If no configuration is specified, NULL can be passed.

Returns

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

Parent topic: Host Memory Management