Function: malloc_host_with_cfg

Applicability

Product	Supported (√/x)
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Function Usage

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.

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)

Parameter Description

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 is allowed. For details, see aclrtMallocConfig.

Return Value Description

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