Function: malloc_host_with_cfg

Applicability

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

Description

Allocates host memory (page-locked memory). The system ensures that the start address of the memory is 64-byte aligned. Compared with the acl.rt.malloc_host API, this API can specify memory-related configuration information when allocating memory.

For the Ascend RC and , 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

C Prototype

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

Python Function

host_ptr, ret= acl.rt.malloc_host_with_cfg(size, cfg)

Parameters

Parameter	Description
size	Int, allocated memory size, in bytes. Must not be 0.
cfg	Dict, memory configuration. If no configuration is specified, an empty dictionary can be transferred. For details, see aclrtMallocConfig.

Return Value

Return Value	Description
host_ptr	Int, address of the pointer to the allocated host memory.
ret	Int, error code. 0 on success; else, failure.

Parent topic: Memory Management