aclrtMemset

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

Initializes memory to a specified value.

The system determines whether the memory to be initialized is on the host or device based on the address. If the host memory is not allocated by calling an acl API (for example, aclrtMallocHost), undefined behavior will occur.

Prototype

1
aclError aclrtMemset(void *devPtr, size_t maxCount, int32_t value, size_t count)

Parameters

Parameter

Input/Output

Description

devPtr

Input

Pointer to the memory start address.

maxCount

Input

Memory size in bytes.

value

Input

Value to set.

count

Input

Memory size to set, in bytes.

Returns

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

Restrictions

This API initializes the memory immediately. No implicit device synchronization or stream synchronization is performed within the function.