aclrtMemsetAsync

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. This API is asynchronous.

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

aclError aclrtMemsetAsync(void *devPtr, size_t maxCount, int32_t value, size_t count, aclrtStream stream)

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.

stream

Input

Stream for executing the memory initialization task. For details about the type definition, see aclrtStream.

Returns

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