aclrtFreeHost

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

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; otherwise, failure. For details, see aclError.

API Call Example

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

Parent topic: Host Memory Management