> ## 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-TW/reference/audio/xapu/structs/xapuresult.md) (如果有的話)。

## 語法

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

### 參數

*handle*   \_In\_\
類型: XApuHandle

呼叫 [XApuConnect](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuconnect.md) 所傳回的控制代碼。

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

從 XAPU 傳回的結果。

### 傳回值

類型: HRESULT

如果成功，會傳回 S\_OK；否則會傳回錯誤碼。

## 備註

如果有的話，會從結果佇列中擷取 [XApuResult](https://docs.xbox.com/zh-TW/reference/audio/xapu/structs/xapuresult.md)，否則呼叫會傳回 [XAPU\_E\_PENDING\_RESULTS](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapuerrors.md)。由於底層處理工作很少，此呼叫會很快傳回。此呼叫是安全執行緒，不過從多個執行緒呼叫它並沒有效能上的優勢。

如果硬體伺服器處於不良狀態，[XApuEnqueueCommand](https://docs.xbox.com/zh-TW/reference/audio/xapu/functions/xapuenqueuecommand.md) 會傳回 [XAPU\_E\_DEVICE\_FATAL\_ERROR](https://docs.xbox.com/zh-TW/reference/audio/xapu/enums/xapuerrors.md) 錯誤碼。在此情況下，所有 XAPU 用戶端都應中斷連線，然後重新連線。

如果此方法失敗，會傳回描述性的錯誤碼。

## 需求

**標頭:** xapu.h

**程式庫:** xapu.lib

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

## 另請參閱

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


## Related topics

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