> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XApuDequeueResult

> XApuDequeueResult

# XApuDequeueResult

如果可用,则从结果队列中检索一个 [XApuResult](/reference/audio/xapu/structs/xapuresult)。

## Syntax

```cpp theme={null}
HRESULT XApuDequeueResult(  
         XApuHandle handle,  
         XApuResult* commandResult  
)  
```

### Parameters

*handle*   \_In\_\
Type: XApuHandle

通过调用 [XApuConnect](/reference/audio/xapu/functions/xapuconnect) 返回的句柄。

*commandResult*   \_Out\_\
Type: [XApuResult\*](/reference/audio/xapu/structs/xapuresult)

从 XAPU 返回的结果。

### Return value

Type: HRESULT

如果成功,则返回 S\_OK;否则,返回错误代码。

## Remarks

如果可用,则从结果队列中检索一个 [XApuResult](/reference/audio/xapu/structs/xapuresult);否则,该调用将返回 [XAPU\_E\_PENDING\_RESULTS](/reference/audio/xapu/enums/xapuerrors)。此调用会快速返回,因为底层处理工作非常少。此调用是线程安全的,但从多个线程调用并不能带来性能优势。

如果硬件服务器处于错误状态,[XApuEnqueueCommand](/reference/audio/xapu/functions/xapuenqueuecommand) 将返回 [XAPU\_E\_DEVICE\_FATAL\_ERROR](/reference/audio/xapu/enums/xapuerrors) 错误代码。在这种情况下,应断开所有 XAPU 客户端并重新连接。

如果此方法失败,将返回具有描述性的错误代码。

## Requirements

**头文件:** xapu.h

**库:** xapu.lib

**支持的平台:** XBOX Series X|S

## See also

[XAPU](/reference/audio/xapu/xapu_members)\
[XApuEnqueueCommand](/reference/audio/xapu/functions/xapuenqueuecommand)\
[XApuGetResultCount](/reference/audio/xapu/functions/xapugetresultcount)


## Related topics

- [XApuConnect](/zh-CN/reference/audio/xapu/functions/xapuconnect.md)
- [XApuCommandId](/zh-CN/reference/audio/xapu/structs/xapucommandid.md)
- [XApuCommandType](/zh-CN/reference/audio/xapu/enums/xapucommandtype.md)
- [XApuGetResultCount](/zh-CN/reference/audio/xapu/functions/xapugetresultcount.md)
- [XAPU](/zh-CN/reference/audio/xapu/xapu_members.md)