acltdtCreateQueue

Applicable Products

Product	Supported
Ascend 950PR/Ascend 950DT	√
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	√

Function

Creates a queue.

Prototype

aclError acltdtCreateQueue(const acltdtQueueAttr *attr, uint32_t *qid)

Parameters

Parameter	Input/Output	Description
attr	Input	Pointer to the queue attribute configuration. For details about the type definition, see acltdtQueueAttr. Call acltdtCreateQueueAttr to create data of the acltdtQueueAttr type and call acltdtSetQueueAttr to set the queue attributes (such as the queue name) in advance. If this parameter is set to nullptr, the default values of the queue attributes are used. That is, the queue name is automatically allocated by the system, and the default queue depth is 8.
qid	Output	Pointer to the queue ID.

Parameter

Input/Output

Description

attr

Input

Pointer to the queue attribute configuration. For details about the type definition, see acltdtQueueAttr.

Call acltdtCreateQueueAttr to create data of the acltdtQueueAttr type and call acltdtSetQueueAttr to set the queue attributes (such as the queue name) in advance.

If this parameter is set to nullptr, the default values of the queue attributes are used. That is, the queue name is automatically allocated by the system, and the default queue depth is 8.

qid

Output

Pointer to the queue ID.

Returns

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

Parent topic: Shared Queue Management