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

# XApuDequeueResult

> XApuDequeueResult

# XApuDequeueResult

如果可用,则从结果队列中检索一个 [XApuResult](https://docs.xbox.com/zh-CN/reference/audio/xapu/structs/xapuresult.md)。

## Syntax

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

### Parameters

*handle*   \_In\_\
Type: XApuHandle

通过调用 [XApuConnect](https://docs.xbox.com/zh-CN/reference/audio/xapu/functions/xapuconnect.md) 返回的句柄。

*commandResult*   \_Out\_\
Type: [XApuResult\*](https://docs.xbox.com/zh-CN/reference/audio/xapu/structs/xapuresult.md)

从 XAPU 返回的结果。

### Return value

Type: HRESULT

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

## Remarks

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

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

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

## Requirements

**头文件:** xapu.h

**库:** xapu.lib

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

## See also

[XAPU](https://docs.xbox.com/zh-CN/reference/audio/xapu/xapu_members.md)\
[XApuEnqueueCommand](https://docs.xbox.com/zh-CN/reference/audio/xapu/functions/xapuenqueuecommand.md)\
[XApuGetResultCount](https://docs.xbox.com/zh-CN/reference/audio/xapu/functions/xapugetresultcount.md)


## Related topics

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