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

## 語法

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

### 參數

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

呼叫 [XApuConnect](/zh-TW/reference/audio/xapu/functions/xapuconnect) 所傳回的控制代碼。

*commandResult*   \_Out\_\
類型: [XApuResult\*](/zh-TW/reference/audio/xapu/structs/xapuresult)

從 XAPU 傳回的結果。

### 傳回值

類型: HRESULT

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

## 備註

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

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

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

## 需求

**標頭:** xapu.h

**程式庫:** xapu.lib

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

## 另請參閱

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


## Related topics

- [XApuDequeueResult](/reference/audio/xapu/functions/xapudequeueresult.md)
- [XApuConnect](/reference/audio/xapu/functions/xapuconnect.md)