从队列中获取数据。同步接口。

Atlas 200/300/500 推理产品，不支持该接口。

Atlas 训练系列产品，不支持该接口。

Atlas A2训练系列产品，不支持该接口。

Atlas 推理系列产品（Ascend 310P处理器），不支持该接口。

aclError acltdtDequeue(uint32_t qid, acltdtBuf *buf, int32_t timeout)

参数名	输入/输出	说明
qid	输入	需要从哪个队列中获取数据。队列需提前调用acltdtCreateQueue接口创建。
buf	输出	共享Buffer指针。
timeout	输入	等待超时时间。当队列空时，如果从队列中获取数据，系统内部会根据设置的等待超时时间来决定如何处理。该参数取值范围如下： -1：阻塞方式，一直等待直到队列有数据后返回。 0：非阻塞方式，当队列空时，直接返回队列空这个错误，这时由用户自行设定重试间隔。 >0：配置具体的超时时间，单位为毫秒。队列空时，等待达到超时时间后返回报错。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的超时时间为1ms，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

参数名

输入/输出

说明

qid

输入

需要从哪个队列中获取数据。

队列需提前调用acltdtCreateQueue接口创建。

buf

输出

共享Buffer指针。

timeout

输入

等待超时时间。当队列空时，如果从队列中获取数据，系统内部会根据设置的等待超时时间来决定如何处理。

该参数取值范围如下：

-1：阻塞方式，一直等待直到队列有数据后返回。
0：非阻塞方式，当队列空时，直接返回队列空这个错误，这时由用户自行设定重试间隔。
>0：配置具体的超时时间，单位为毫秒。队列空时，等待达到超时时间后返回报错。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的超时时间为1ms，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

返回0表示成功，返回其它值表示失败。