acltdtGetBufData

Applicability

Product	Supported
Atlas 350 Accelerator Card	x
Atlas A3 training product/Atlas A3 inference product	x
Atlas A2 training product/Atlas A2 inference product	x
Atlas inference product	x
Atlas training product	x

Function

Obtains the pointer to and length of the data area within the shared buffer. You can use this pointer to fill in data.

API call sequence: Call acltdtAllocBuf or acltdtCopyBufRef to allocate the shared buffer, call acltdtGetBufData to obtain the memory pointer to and length of the shared buffer, and fill valid data in the buffer. Then, call acltdtSetBufDataLen to set the length of the valid data in the shared buffer to a value less than that obtained by calling acltdtGetBufData.

Prototype

aclError acltdtGetBufData(const acltdtBuf buf, void **dataPtr, size_t *size)

Parameters

Parameter	Input/Output	Description
buf	Input	Pointer to the shared buffer. For the type definition, see acltdtBuf. The shared buffer must be obtained by calling acltdtAllocBuf or acltdtCopyBufRef.
dataPtr	Output	Pointer to the data area (address on the device).
size	Output	Length of the data area, in bytes.

Parameter

Input/Output

Description

buf

Input

Pointer to the shared buffer. For the type definition, see acltdtBuf.

The shared buffer must be obtained by calling acltdtAllocBuf or acltdtCopyBufRef.

dataPtr

Output

Pointer to the data area (address on the device).

size

Output

Length of the data area, in bytes.

Returns

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

Restrictions

For the Atlas 200I/500 A2 inference product, this API can be used only in the Ascend RC.

Parent topic: Shared Buffer Management