aclrtFreeHost

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	√

Description

Frees the host memory allocated by the aclrtMallocHost or aclrtMallocHostWithCfg API.

This API immediately frees the input memory. It does not perform implicit device synchronization or stream synchronization or wait until the tasks that use the memory are complete. Ensure that the memory pointer is not accessed after this API is called.

Prototype

      
           aclError aclrtFreeHost(void *hostPtr)

Parameters

Parameter	Input/Output	Description
hostPtr	Input	Pointer to memory to free.

Returns

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

API Call Example

For the API call example, see Host Page-Locked Memory Usage.

Parent topic: Memory Management