acltdtGetBufData

Applicable Products

Product	Supported
Ascend 950PR/Ascend 950DT	x
Atlas A3 training products/Atlas A3 inference products	x
Atlas A2 training products/Atlas A2 inference products	x
Atlas 200I/500 A2 inference products	√
Atlas inference products	x
Atlas training products	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 details about 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 details about 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 Ascend RC form.

Parent topic: Shared Buffer Management