acltdtEnqueue

The Atlas 200/300/500 Inference Product does not support this API.

The Atlas Training Series Product does not support this API.

Adds data to a queue. The buffer for storing data must be allocated by calling acltdtAllocBuf.

aclError acltdtEnqueue(uint32_t qid, acltdtBuf buf, int32_t timeout)

Parameter	Input/Output	Description
qid	Input	Queue to which data is to be added. You must call acltdtCreateQueue to create a queue in advance.
buf	Input	Pointer to the shared buffer. You must call acltdtAllocBuf in advance to allocate the buffer.
timeout	Input	Wait timeout interval. If data is added to a full queue, the system determines how to process the data based on the configured wait timeout interval. The options are as follows: -1: blocking mode. The system waits until data is successfully added to the queue. 0: non-blocking mode. When the queue is full, the error indicating that the queue is full is returned. In this case, the retry interval can be set by the user. > 0: specified timeout interval, in ms. When the queue is full, an error is returned after the timeout interval has elapsed. The timeout interval varies with the operating system. The deviation is generally within a time slice of an operating system. For example, if the time slice of an operating system is 4 ms and the value of wait timeout interval is set to 1 ms, the actual timeout interval ranges from 1 ms to 5 ms. When the CPU load is high, the timeout interval may fluctuate.

Parameter

Input/Output

Description

qid

Input

Queue to which data is to be added.

You must call acltdtCreateQueue to create a queue in advance.

buf

Input

Pointer to the shared buffer.

You must call acltdtAllocBuf in advance to allocate the buffer.

timeout

Input

Wait timeout interval. If data is added to a full queue, the system determines how to process the data based on the configured wait timeout interval.

The options are as follows:

-1: blocking mode. The system waits until data is successfully added to the queue.
0: non-blocking mode. When the queue is full, the error indicating that the queue is full is returned. In this case, the retry interval can be set by the user.
> 0: specified timeout interval, in ms. When the queue is full, an error is returned after the timeout interval has elapsed. The timeout interval varies with the operating system. The deviation is generally within a time slice of an operating system. For example, if the time slice of an operating system is 4 ms and the value of wait timeout interval is set to 1 ms, the actual timeout interval ranges from 1 ms to 5 ms. When the CPU load is high, the timeout interval may fluctuate.

The value 0 indicates success, and other values indicate failure. For details, see aclError.

Parent topic: Shared Queue Management